Skip to content

ispras/cv

 
 

Repository files navigation

Continuous Verification Framework

Apache 2.0 License

This framework aims at results analysis of continuous verification, which can be applied to software systems.

Visualization of verification results

Witness Visualizer

Witness Visualizer converts generic witnesses from SV-COMP tools into user-friendly format.

Requirements

Python (version>=3.4), python modules:

sudo pip3 install requests ujson graphviz ply pytest atomicwrites more-itertools pluggy py attrs setuptools six django==2.1 psycopg2 pycparser sympy

Deployment

In order to install Witness Visualizer in the <deployment directory> execute the following command:

make install-witness-visualizer DEPLOY_DIR=<deployment directory>

Usage

After deployment Witness Visualizer can be used to convert witnesses from the <deployment directory> with command:

scripts/visualize_witnesses.py OPTIONS

Primary options:

  • -w WITNESS, --witness WITNESS: path to the witness to be visualized;
  • -d DIRECTORY, --directory DIRECTORY: directory with witnesses to be visualized (either -w or -d option must be specified);
  • -r RESULT_DIR, --result-dir RESULT_DIR: directory, in which visualized witnesses will be placed in html format;
  • -s SOURCE_DIR, --source-dir SOURCE_DIR: source files directory;
  • --dry-run: do not visualize witnesses, only check their quality;
  • -u, --unzip: unzip archives with visualized witnesses.

For example:

scripts/visualize_witnesses.py --witness output/witness.graphml --result-dir results/ --source-dir ~/sv-benchmarks

There are some examples of SV-COMP witnesses in the docs/examples/witnesses directory, which can be used to validate Witness Visualizer installation.

Benchmark Visualizer

Benchmark Visualizer is a tool for visualizing benchmark verification results.

Deployment

  1. Web-interface

See instruction docs/web_interface.txt.

  1. Control scripts

In order to install Benchmark Visualizer in the <deployment directory> execute the following command:

make install-benchmark-visualizer DEPLOY_DIR=<deployment directory>

Usage

See instruction docs/benchmark_visualizer.md.