lanecodes / crafty_brazil Goto Github PK

James and I took screenshots of his Eclipse configuration on 2nd December (see attached). These confirm the following details are needed to run a simulation:

• Entry point is main in org.volante.abm.serialization.ModelRunner
• Program is run with arguments -f xml/Scenario.xml -n 1 -o 0 -r 1.

The command line options for ModelRunner are given in the legacy getting started instructions in the CRAFTY docs. Of those used above we have

• -f is location of scenario file relative to the data directory. The data directory can be specified by the -d option, but apparently defaults to ./data.
• -n is the number of runs
• -o is random seed offset
• -r is Number of runs of configuration with random seed

We should document how a user could initialise such a configuration from the command line. This supports running models from inside containers.

The CRAFTY docs are light on information about how to build CRAFTY. This is important because we will need to make changes to the CRAFTY code and it would be good to be able to do so without needing to check in additional binaries.

I have not been able to find a .pom or build.xml file, indicating CRAFTY is not normally built with Maven or Ant. I have, however, found some ant scripts in config/ant, though these seem to be about publishing models or running them on clusters rather than simply compiling changes to source code. There is also an Eclipse ./.project file present containing build configuration. I wonder if CRAFTY is traditionally built using Eclipse. If so we should document this and think of how to build on the command line as an alternative to facilitate containerisation and CI.

See resources

• Build Eclipse Java Project from Command Line
• javac option to compile all java files under a given directory recursively