odtp-mobility-simulation

ODTP component for running mobility simulation

Tool Info	Links
Original Tool	https://github.com/irmlma/mobility-simulation
Current Tool Version	351ebf85e0872c558d124f502f9a347039042849

ODTP command

odtp new odtp-component-entry \
--name odtp-mobility-simulation \
--component-version v0.1.1 \
--repository https://github.com/odtp-org/odtp-mobility-simulation.git

Data sheet

Parameters

Parameter	Description	Default Value
WAIT_TYPE	parameters from empirical distribution	lognormal
WAIT_MU	parameters from empirical distribution	0.75
WAIT_SIGMA	parameter for lognormal	1.49
WAIT_ALPHA	parameter for both powerlaw (default 1.2) and truncpowerlaw (default 1.1)	1.2
WAIT_LAMBDA	parameters for truncpowerlaw	0.5
JUMP_TYPE	to be developed	lognormal
JUMP_MU	parameter for lognormal	7.72
JUMP_SIGMA	parameter for lognormal	2.38
JUMP_ALPHA	parameter for both powerlaw (default 1.2) and truncpowerlaw (default 1.1)	2.38
JUMP_LAMBDA	parameters for truncpowerlaw	0.5
RHO_TYPE	TBD	normal
RHO_MU	TBD	0.64
RHO_SIGMA	TBD	0.16
GAMMA_TYPE	TBD	normal
GAMMA_MU	TBD	0.18
GAMMA_SIGMA	TBD	0.069
P	shall be within [0, 1]; change to non-0 value to perform hard interventions	0
LOC_SEQ_FILE	Input filename	loc_seq.csv
LOCS_FILE	Input filename	locs.csv

Data Inputs

File/Folder	Type	Path	Description	Parameter
loc_seq.csv	csv	null	TBD	LOC_SEQ_FILE
locs.csv	csv	null	TBD	LOCS_FILE

Data Output

File/Folder	Type	Path	Description
dtepr.csv	csv	dtepr.csv	TBD

Tutorial

How to run this component in docker.

1. Prepare manually a folder called odtp-input containing the following datafolder of our selected scenario:

• data

2. Create your .env file following the example in .env.dist.

3. Build the dockerfile

docker build -t odtp-mobility-simulation .

4. Run the following command. Mount the correct volumes for input/output folders.

docker run -it --rm \
-v {PATH_TO_YOUR_INPUT_VOLUME}:/odtp/odtp-input \
-v {PATH_TO_YOUR_OUTPUT_VOLUME}:/odtp/odtp-output \
--env-file .env odtp-mobility-simulation

docker run -it --rm -v /c/Users/Carlos/pro/odtp-mobility-simulation/odtp-input:/odtp/odtp-input -v /c/Users/Carlos/pro/odtp-mobility-simulation/odtp-output:/odtp/odtp-output --env-file .env odtp-mobility-simulation

Changelog

• v0.1.1

  • Client updated to v0.1.2
  • Github action for dockerhub publishing inlcuded
  • Added fix when building on windows

• v0.1.0

  • Initial release

Development.

Developed by SDSC/CSFM.