README.md

CRISPR: QuISP Benchmark Runner

Prerequisites

• Poetry

Getting Started

# install dependencies
$ poetry install

# activate virtual env 
# (if you don't want to make your environment dirty)
$ poetry shell

# install crispr command in editable mode
$ pip install -e .

# then you can use the "crispr" command
# show help
$ crispr --help

Usage

# validate your plan file 
$ crispr plan ./simulation.plan

# run all simulations
$ crispr run ./simulation.plan -r ../your-quisp-repository -o ../output-dir

# run simulations with 16 workers
$ crispr run ./simulation.plan -r ../your-quisp-repository -o ../output-dir -p 16

# and you can type Ctrl-C to stop the simulations

# then you can resume the stopped simulation
$ crispr resume

# you can check the stopped simulations status
$ crispr status

Results Directory

results/{TIMESTAMP}-{TITLE}
├── results          // dir for the simulation outputs
├── ned              // dir for all copied ned files
├── topology         // dir basic network topology definitions
├── analysis.ipynb   // jupyter notebook for instant analysis
├── commit.txt       // git commit hash and name for the quisp repo
├── omnetpp.ini      // generated ini by plan
├── quisp_bin        // quisp executable
├── results.pickle   // all results as dict
└── simulation.plan  // the plan file