ScaleSim

ScaleSim is a large-scale distributed and parallel discrete event simulator, based on optimistic PDES (Parallel Discrete Event Simulation).

ScaleSim provides Exact-Differential execution, proposed in

• "Exact-Differential Simulation: Differential Processing of Large-Scale Discrete Event Simulations" (TOMACS 2018)
• "Towards Large-Scale What-If Traffic Simulation with Exact-Differential Simulation" (WSC 2015)
• "Exact-Differential Large-Scale Traffic Simulation" (SIGSIM PADS 2015)

Requirement

• MPI (Open MPI)
• boost, boost_mpi, boost_thread, boost_system, boost_serialization, boost_filesystem,
• leveldb, snappy,
• gtest, glog, gflags,

Tested version

• Open MPI 1.8.8 (MPI 3.0), 1.10.0 (MPI 3.0)
• boost 1.57.0, 1.58.0
• leveldb 1.18, snappy 1.1.3
• gtest 1.7.0, glog 0.3.3, gflags 2.1.2

Build

Make a build directory

$ mkdir build
$ cd build

Configure and compile (require c++11)

$ cmake ..
$ make

Run Example

Single Simulation

$ mpirun -np 4 ./build/TrafficSim \
                 ./traffic/ring/part/graph.part.4 \
                 ./traffic/ring/rd.sim.csv \
                 ./traffic/ring/trip.csv

Exact-Differential Simulation

You should define:

• --sim_id : simulation task ID. In repeating execution, the simulator reads same ID inputs.
• --store_dir or --store_ip : directory path or IP address to store results.

For initial execution, use --diff_init option.

$ mpirun -np 4 ./build/TrafficSim --sim_id=999 --store_dir="./tmp" --diff_init \
                 ./traffic/ring/part/graph.part.4 \
                 ./traffic/ring/rd.sim.csv \
                 ./traffic/ring/trip.csv

For repeat execution, use --diff_repeat option.

$ mpirun -np 4 ./build/TrafficSim --sim_id=999 --store_dir="./tmp" --diff_repeat \   
                 ./traffic/ring/part/graph.part.4 \
                 ./traffic/ring/rd.sim.csv \
                 ./traffic/ring/add_ev.csv  

Test

$ ./build/Test

You can filter test types with gtest_filter

$ ./build/Test --gtest_filter=*small　  # Small test
$ ./build/Test --gtest_filter=*meduim   # Medium test
$ ./build/Test --gtest_filter=*large    # Large test