An agentbased demand model (ABM) developed at the Institute of Transport Research at the German Aerospace Center (DLR).
When using it, you are obligated to cite it as:
Heinrichs, Matthias and Krajzewicz, Daniel and Cyganski, Rita and von Schmidt, Antje (2017) Introduction of car sharing into existing car fleets in microscopic travel demand modelling. Personal and Ubiquitous Computing, Seiten 1-11. Springer. doi: 10.1007/s00779-017-1031-3. ISSN 1617-4909
For more information see the TAPAS Wiki or the TAPAS Source Code Documentation.
Here. The tapas-x.y.z-all.jar is a fat jar with all dependencies included. The tapas-x.y.z.jar only contains the compiled TAPAS code without dependencies.
- Installed and running Postgres 11+ server with
- Postgis 3 extension
- Database Drivers: pgJDBC and pgODBC (32 and/or 64 bit depending on your build target)
- Java 11+ (for development options you need the JDK of course)
- Git if you want to clone this repository
This only applies if you don't have an already running Postgres/Postgis system.
Get Postgres 11 for your operating system and install it. Also, add the Postgis extension to your postgres server.
Initialize local DB Server (if not happened already):
initdb[.exe] -D path/to/data/dir -E UTF8 -U DEFAULTSUPERUSER --pwprompt
DEFAULTSUPERUSER should probably be 'postgres', but you can set whatever you want.
Start DB server:
pg_ctl[.exe] -D path/to/data/dir -l /path/to/log/file start
Clone (or fork) the repository from GitHub
git clone https://github.com/DLR-VF/TAPAS.git
or download the specific files you want.
Some basic information about important files of the repository:
- TAPAS-<version>-all.jar: the main jar for TAPAS. Important is the ...-all.jar because it includes all dependencies
- sql_dumps.zip: Minimal database dump: leave the zip as is for the Installer
- data/Simulations: Runtime data archive: exemplary set of scenario and runtime files (needed for SimulationDaemon and SimulationControl); these files contain the login and database parameter settings
- src: Source folder
- gradle/wrapper: Gradle wrapper folder for executing task through gradle; should not be changed
- build.gradle.kts: Main Gradle file for defining the gradle tasks and more
Recommendation: Place the still compressed sql_dumps.zip archive, in your current working directory with your TAPAS-<version>-all.jar
The Installer creates a minimal functioning install of a TAPAS database on your Postgres server. It needs four
parameters to work, dbserver, dbname, dbuser, and dbpassword. See
java -cp TAPAS-<version>-all.jar de.dlr.ivf.tapas.installer.Installer --help
for more information. The dbuser must be a superuser or a user with
sufficient rights on the postgres server.
Additionally, there must be an sql_dumps.zip archive in your current active directory. If not, you will be asked for the archive through a prompt.
Start the Installer with
java -cp TAPAS-<version>-all.jar de.dlr.ivf.tapas.installer.Installer
or
java -cp TAPAS-<version>-all.jar de.dlr.ivf.tapas.installer.Installer --dbserver=localhost --dbname=tapas --dbuser=postgres --dbpassword=postgres
The commandline arguments are optional. You can omit them, but then you will be prompted during the Installer run.
Note: This is the recommended way to running the Installer because in this case you can omit the password argument in the command line. You will be then prompted during the run of the script with a secret input of the db password. If you run this script through Gradle or an IDE it is necessary to deliver the argument beforehand because Java does not recognize their standard command line input.
There are several ways to execute the Installer, SimulationControl and the SimulationDaemon. The most basic one is through the command-line. Other options are via Gradle through the command-line or through IntelliJ IDEA or Eclipse.
The SimulationControl center is a gui tool for managing your simulations and your simulation processes.
If not already present it asks for a runtime.csv which contains the db server login information and more.
An exemplary file is located in the data/Simulations folder.
Start SimulationControl:
`java -jar TAPAS-<version>-all.jar`
or
java -cp TAPAS-<version>-all.jar de.dlr.ivf.tapas.runtime.client.SimulationControl
The SimulationDaemon connects to the db server and starts a SimulationServer which simulates the scenarios.
You need to specify the path to a simulation folder (in the TAPAS project is an example folder data /Simulations) where a runtime.csv is present.
Start SimulationDaemon:
java -cp TAPAS-<version>-all.jar de.dlr.ivf.tapas.runtime.server.SimulationDaemon path/to/simulations/folder
ToDo
There is a tutorial video, which explains the installation process via gradle. Watch it or read on, it's your choice!
Clone (or fork) the whole repository from GitHub
git clone https://github.com/DLR-VF/TAPAS.git
Note: The gradle executable is called gradlew. On Linux one uses ./gradlew to execute it in a terminal, on Windows
it is gradlew.bat. Examples are given in Linux command style.
-
You can compile the project and build the
TAPAS.jar(without dependencies)/TAPAS-<version>-all.jar(with deps) through./gradlew build -
Cleanup the project:
./gradlew clean -
Execute Installer with Gradle:
./gradlew Installer --args="--dbserver=localhost --dbname=tapas --dbuser=postgres --dbpassword=postgres"The commandline arguments must be supplied through the
--args="..."parameter. You cannot enter the arguments during the Installer run because Gradle (and other IDEs) do not work with the standard input. -
SimulationControl:
./gradlew SimulationControl -
SimulationDaemon:
./gradlew SimulationDaemon --args="path/to/simulations/folder"
There is a tutorial video, which explains the installation process via gradle. Watch it or read on, it's your choice!
File -> Open... -> Either choose the cloned TAPAS folder or the build.gradle.kts file to import the project. The dependencies should be downloaded automatically.
In the Gradle menu in IntelliJ (either on the right side or press double shift -> type in Gradle -> Under Actions -> Gradle) you find the most important tasks:
- Build project:
TAPAS -> Tasks -> build -> build(theTAPAS-<version>-all.jarjar is located inbuild/libs/) - Clean project:
TAPAS -> Tasks -> build -> clean - Run Installer script :
TAPAS -> Tasks -> runnables -> Installer(set arguments in build.gradle.kts in the Installer section) - Run SimulationControl:
TAPAS -> Tasks -> runnables -> SimulationControl - Run SimulationDaemon:
TAPAS -> Tasks -> runnables -> SimulationDaemon(expects the simulation directory to be indata/Simulations)
TODO
DLR-VF
- Homepage: TAPAS-Homepage (in German)
- e-mail:
- Youtube: VF-MUD-G3
- Twitter (for general transport topics): @DLR_Verkehr