Custom MATSim in Tramola
Learn how to build a custom MATSim version you can use to start runs from within Tramola.
Prepare your MATSim version
First, you need to add the Tramola-Matsim integration code to your MATSim version, so that the MATSim run can communicate with Tramola. To do this, follow the steps outline in Integrating Tramola.
Then, create a “release” of your custom MATSim code, e.g. a zip-file or fat-jar containing everything to run your customized MATSim version.
Add your custom MATSim version to Tramola
For this step, you need administrative rights in Tramola (the first user created when setting up Tramola has administrative rights).
Click on “Settings” in the left navigation bar. Then, click on “Job Templates”. You will see a list of the currently available Job Templates. Click on “Add a Job Template” in the top right.
Now you can specify a name for your Job Template. Configure it the following way:
- MATSim: select
None - Tramola Integration: select the
Tramola for MATSim 15.0(Yes, this is necessary, even if you have already included the code in your custom MATSim version). - Additional Files: Upload your custom MATSim release. If it is a zip-file, it will automatically be extracted when starting a run.
- Java Command: Choose
MATSim Controleras template, and modify it to reflect your directory and jar-file name, as well as your main class.
Click on Save.
Add a scenario
Now you can add a scenario as outlined in Start a Run in Tramola.
Start your run
Click on Start a Run on your scenario page when you are ready for running your scenario the first time. You are presented an overview of what files will be used, can optionally choose one or more Changesets if you have edited the scenario, and can perform other settings.
Make sure to use your custom Job Template as Job Type, and specify enough memory for you scenario.
Finally, click on Start Run.