pyhf到Combine转换器

将模型从pyhf转换为CMS Combine的工具体

此工具已完全验证，可以生成相同的模型结构和预期产量，以及生成彼此中心值在1%以内的拟合。这是通过比较NLL图、拉力图和原始差异计算来完成的。

Combine环境

要使用该包，必须首先创建一个能够运行Combine的docker容器。安装Docker后，执行以下命令。

docker pull pyhf/pyhf-combine-converter:cmssw-11.2.0-python3
docker run --rm -ti -P --device /dev/fuse --cap-add SYS_ADMIN --security-opt apparmor:unconfined -e CVMFS_MOUNTS="cms.cern.ch oasis.opensciencegrid.org" pyhf/pyhf-combine-converter:cmssw-11.2.0-python3

如果docker容器正在运行，但Combine命令没有正确挂载，请在容器内运行以下命令

source /cvmfs/cms.cern.ch/cmsset_default.sh
cmsenv

安装

在包含Combine的Python环境中运行pyhf-combine-converter可从PyPI安装。

python3 -m pip install pyhf-combine-converter

使用

pyhf-combine-converter 提供了一个 CLI API，用于 pyhf 和 Combine 之间的双向转换。

从 pyhf 转换到 Combine

pyhf-to-combine $JSON_FILE_NAME --shape-file $SHAPES_FILE_NAME --out-datacard $DATACARD_FILE_NAME

从 Combine 转换到 pyhf

combine-to-pyhf $DATACARD_FILE_NAME --out-file $JSON_FILE_NAME

关于任何问题或问题，请参阅 docs/ 文件夹，其中更详细地介绍了翻译。

致谢

这项工作是在 Peter Ridolfi 的 IRIS-HEP Fellow 项目 的框架内完成的，该项目得到了 NSF 合作协议 OAC-1836650 的支持。