A Demo of Parf

by carolt 1 month ago

macOS ◆ xterm-256color ◆ zsh 118 views

A brief demo of using Parf, a lightweight and fully automated parameter tuning tool for the abstract interpretation-based static analyzer Frama-C/Eva. To use Parf, please install the docker image and more details can be found on this page:

Install Docker as per https://docs.docker.com/engine/install/.
Pull Parf from dockerhub:
```
docker pull parfdocker/parf:v2.0
```
To check whether you have successfully pulled the correct docker image: run docker images and see if parfdocker/parf exists.

Run the Docker container:

docker run -it --platform linux/amd64 --entrypoint /bin/bash -u vscode parfdocker/parf:v2.0

You should be in a terminal environment as a user. Then

cd /home/vscode

Synchronize the environment with the current opam switch in the container:
```
eval $(opam env)
```
Check whether Frama-C and Mopsa are available in the container:
```
frama-c --version
```
and
```
mopsa-c -v
```
Check the usage of Parf:
```
frama-c -parf-h
```

You can download this recording in asciicast v2 format, as a .cast file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 680842.cast

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/680842.cast',
      document.getElementById('player'),
      { cols: 96, rows: 56 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/680842 demo.gif

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.