mobitopp's Introduction

mobiTopp

mobiTopp is an agent-based travel demand model developed at the Institute for transport studies at the Karlsruhe Institute of Technology. Publications about mobiTopp can be found on the project site.

Execution

Using gradle

The example project comes shipped with gradle tasks to run it directly from source. A population can be generated with the runPopulationSynthesis task and travel demand can be simulated using the runSimulation task.

./gradlew runPopulationSynthesis runSimulation

Using eclipse

The example project contains preconfigured launch configurations to create a population and simulate the travel demand. Eclipse automatically detects them and you can run them from the toolbar as every other launch configuration.

Results

mobiTopp generates various output files during population synthesis and simulation. Most of the output data is self-explanatory. For those values which are not, the following tables map the codes to their values.

ActivityType

Code	Description
1	WORK
2	BUSINESS
3	EDUCATION
4	SHOPPING
5	LEISURE
6	SERVICE
7	HOME
8	UNDEFINED
9	OTHERHOME
11	PRIVATE_BUSINESS
12	PRIVATE_VISIT
21	BUSINESS_OUT
22	BUSINESS_TO_WORK
23	DELIVER_PARCEL
24	BUSINESS_TRAVEL
31	EDUCATION_PRIMARY
32	EDUCATION_SECONDARY
33	EDUCATION_TERTIARY
34	EDUCATION_OCCUP
41	SHOPPING_DAILY
42	SHOPPING_OTHER
51	LEISURE_INDOOR
52	LEISURE_OUTDOOR
53	LEISURE_OTHER
54	LEISURE_SIGHTSEEING
55	LEISURE_TRAVEL
71	PICK_UP_PARCEL
77	LEISURE_WALK

ModeType

Code	Description
-2	UNDEFINED
-1	UNKNOWN
0	BIKE
1	CAR
2	PASSENGER
3	PEDESTRIAN
4	PUBLICTRANSPORT
5	TRUCK
6	PARK_AND_RIDE
7	TAXI
11	CARSHARING_STATION
12	CARSHARING_FREE
15	E_SCOOTER
16	PEDELEC
17	BIKESHARING
21	RIDE_POOLING
22	RIDE_HAILING
23	PREMIUM_RIDE_HAILING

EmploymentType

Code	Description
-1	UNKNOWN
1	FULLTIME
2	PARTTIME
22	MARGINAL
3	UNEMPLOYED
4	STUDENT
40	STUDENT_PRIMARY
41	STUDENT_SECONDARY
42	STUDENT_TERTIARY
5	EDUCATION
6	HOMEKEEPER
7	RETIRED
8	INFANT
9	NONE

Gender

Code	Description
1	MALE
2	FEMALE

DomCode

Code	Size of household	Number of cars
1	1	0
2	1	1
3	1	>=2
4	2	0
5	2	1
6	2	>=2
7	3	0
8	3	1
9	3	>=2
10	>=4	0
11	>=4	1
12	>=4	>=2

mobitopp's People

Contributors

Stargazers

Watchers

mobitopp's Issues

Trips in "demandsimulationResult.csv" are only a few meters long

I cloned this git repository and – without changing anything – ran ./gradlew runPopulationSynthesis runSimulation in the project directory.

After going through the output and results folders I quickly identified results/simulation/demandsimulationResult.csv to be the output file of my interest. This file contains approximately 40.000 rows with each row describing one trip of one person including start time, end time, start geopoint and end geopoint.

However, after going through the first couple of rows of this file I quickly identified a problem: The start geopoint and the end geopoint always only lie a few meters apart from each other. To confirm this problem on a larger scale (I could not go through 40.000 rows manually), I imported demandsimulationResult.csv into Apple Numbers. Next, I added conditional formatting to the column distanceInKm to determine whether any trip has a distance of more than 1 km. As it turned out, no trip has.

If I understand mobitopp and its outputs right, this result is not intended: One trip should represent the way of one person from one place to another. Thus, trip distances of a few meters don't make any sense.

In conclusion, there are several possibilities why I experienced this issue:

I did something wrong using mobitopp. In this case, I would love to get some feedback.
mobitopp does not run out of the box and needs some more input files to work correctly. In this case, I would love to know what input files it needs.
This is an issue on the part of mobitopp.

In general, I am missing documentation for mobitopp. As stated in README.md, the outputs of mobitopp are quite self-explanatory. However, what is not self-explanatory are the inputs that mobitopp needs.

I am looking forward to an answer and attached my demandsimulationResult.csv file.
demandsimulationResult.csv

Regards,
Paul

Recommend Projects

kit-ifv / mobitopp Goto Github PK