-
Notifications
You must be signed in to change notification settings - Fork 71
EMLab in Headless Mode
EMLab-Generation can be run in headless mode, and can in this way automatically run a range of scenarios on a single machine, or even on a High-Performance Cluster.
The necessary scripts to do so, can be found in the folder shellscripts/headlessScripts. Before starting to use them, it is necessary to configure their usage by filling out the template TEMPLATE_scriptConfigurations.cfg and saving it as scriptConfigurations.cfg. In this way the scenario folder, results folder etc. can be defined. If the scripts are only to be run locally, the fields with REMOTE or SERVER can be left empty.
The scripts to run EMLab locally are localHeadlessSingle.sh, to run a single run of EMLab and localHeadlessArray.sh to run a range of scenarios. localHeadlessSingle.sh can be called with localHeadlessSingle.sh YOURJOBNAME SCENARIONAME (QUERYFILE) where YOURJOBNAME is an arbitrary name, SCENARIONAME the scenario file name without the .xml file ending and QUERYFILE an optional parameter that can be passed to change the query file, which determines which queries are saved at the end of each tick.
localHeadlessArray.sh is run similarly with localHeadlessSingle.sh YOURJOBNAME SCENARIONAME START END (QUERYFILE). START and END should be numbers and define the set of scenarios that are run, if these scenario files follow the naming start SCENARIONAME-START.xml to SCENARIONAME-END.xml (e.g. scenarioA-ToyModel-0.xml, scenarioA-ToyModel-1.xml, scenarioA-ToyModel-2.xml, ...).