Skip to content

Latest commit

 

History

History
executable file
·
76 lines (60 loc) · 2.21 KB

README.md

File metadata and controls

executable file
·
76 lines (60 loc) · 2.21 KB

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