Certificates and Witnesses for Multi-Objective Queries in Markov Decision Processes - Artefact - PEVA

SummaryThis artifact accompanies the PEVA submission "Certificates and Witnesses for Multi-Objective Queries in Markov Decision Processes". It contains the implementation (switss-multi) of the presented techniques, that is, the computation of certificates, witnessing subsystems and schedulers for multi-objective queries in MDPs. Further, the artifact contains the PRISM models, PRISM properties and scripts bundled in a Docker image for completely reproducing the experimental results presented in Section 6. Additionally, it also contains the original raw experimental data presented in Section 6 and the corresponding analysis scripts. Lastly, we provide a documentation of our implementation switss-multi and describe how to use our tool via its command-line and programmatically via its Python interface. Relation to paperThis artifact can be used to reproduce all the experimental results (including examples) presented in the paper, that is:- The toy examples presented in Example 12, Example 14, Example 22 and Example 34- Table 3 in Section 6- Table 4 in Section 6- Table 5 in Section 6- Table 8 in Section 6- Figure 9 in Section 6- Figure 10 in Section 6- Figure 11 in Section 6 StructureThis artifact consists of the following files and folders:- data: Contains original raw experimental data presented in Section 6. Additionally, the log files and scripts for summarizing the raw experimental data are provided.- switss-multi/experiments: Contains the PRISM models, PRISM properties (queries) and scripts for running the experiments.- switss-multi: The source code of the implementation of our presented techniques.- switss-multi-docs: A documentation of the Python API of switss-multi.- peva-docker-image.tar.gz: The compressed Docker image, with the installed implementation (switss-multi), PRISM models, PRISM properties and the scripts for running the experiments and analysing the raw experimental data. Moreover, it contains a copy of the data folder, in case you want to run the analysis scripts on the original data.- docker-results: An empty folder that will be populated with results when running the experiments and analysis with the provided Docker image.- LICENSE: The license of this artifact (MIT license).- GUROBI-EULA: The end-user license agreement of Gurobi (also see https://pypi.org/project/gurobipy/).- GPL-3.0: The GPL 3.0 license. It is included because our dependency Storm (https://www.stormchecker.org) is licensed under it.### 概述 本附属套件对应PEVA投稿论文《马尔可夫决策过程多目标查询的证书与见证集》（"Certificates and Witnesses for Multi-Objective Queries in Markov Decision Processes"）。套件包含本文提出技术的实现（switss-multi），即针对马尔可夫决策过程（Markov Decision Processes, MDPs）的多目标查询的证书、见证子系统与调度器的计算实现。此外，本套件还包含打包为Docker镜像的PRISM模型、PRISM属性与实验脚本，可完全复现第6节中展示的实验结果；同时附带第6节中展示的原始实验数据，以及对应的分析脚本。最后，我们提供了switss-multi的实现文档，并说明了如何通过命令行以及Python编程接口使用该工具。 ### 与论文的关联 本套件可复现论文中所有实验结果（含所有示例），具体包括： - 示例12、示例14、示例22与示例34中的玩具示例； - 第6节的表3、表4、表5、表8； - 第6节的图9、图10、图11。 ### 结构 本附属套件包含以下文件与文件夹： - `data`：存储第6节中的原始实验数据，同时提供用于汇总原始实验数据的日志文件与脚本。 - `switss-multi/experiments`：包含PRISM模型、PRISM查询属性与用于运行实验的脚本。 - `switss-multi`：本文所提出技术的实现源代码。 - `switss-multi-docs`：switss-multi的Python应用程序编程接口（API）文档。 - `peva-docker-image.tar.gz`：压缩后的Docker镜像，其中预装了switss-multi实现、PRISM模型、PRISM属性，以及用于运行实验与分析原始实验数据的脚本。此外，该镜像中包含一份`data`文件夹副本，方便用户基于原始数据运行分析脚本。 - `docker-results`：空文件夹，当使用提供的Docker镜像运行实验与分析脚本时，将生成实验结果并填充至该文件夹。 - `LICENSE`：本套件的许可证（MIT许可证）。 - `GUROBI-EULA`：Gurobi的最终用户许可协议（可参考https://pypi.org/project/gurobipy/）。 - `GPL-3.0`：GNU通用公共许可证第3.0版，因本项目依赖Storm（https://www.stormchecker.org）而附带该许可证。