RECAST for ATLAS

ATLAS工具，用于将ATLAS分析集成到RECAST

入门指南

安装

recast-atlas可以通过在Python虚拟环境中使用pip从PyPI安装

python -m pip install recast-atlas

CLI API

recast-atlas 命令行界面（CLI）API

$ recast --help
Usage: recast [OPTIONS] COMMAND [ARGS]...

Options:
  -l, --loglevel TEXT
  --help               Show this message and exit.

Commands:
  auth       Authentication Commands (to gain access to internal data)
  backends   The RECAST computational backends.
  catalogue  The RECAST Analysis Catalogue
  ci         Helper Commands for CI systems
  retrieve   Retrieve RECAST Results from asynchronous submissions
  run        Run a RECAST Workflow synchronously
  software   Build Container Images for RECAST
  status     Get the Status of a asynchronous submission
  submit     Submit a RECAST Workflow asynchronously
  tests      Run a test

运行 RECAST

recast-atlas 旨在实现本地执行以及 REANA 集群上的异步执行。

Docker 后端

示例：使用（默认）docker 后端运行来自 ATLAS Exotics Rome Workshop 2018 的 示例。

从 PyPI 安装 recast-atlas

python -m pip install --upgrade recast-atlas coolname

将 RECAST 工作流提交到 recast/recastatlas Docker 容器中进行编排

recast run examples/rome --backend docker --tag "docker-$(coolname 2)"

本地后端

示例：使用 local 后端运行来自 ATLAS Exotics Rome Workshop 2018 的 示例。

使用 local 附加组件安装 recast-atlas

python -m pip install --upgrade 'recast-atlas[local]' coolname

将 RECAST 工作流提交到本地运行

PACKTIVITY_DOCKER_CMD_MOD="-u root" recast run examples/rome --backend local --tag "local-$(coolname 2)"

local 后端在本地编排工作流图，但请注意，不同的工作流步骤仍在 Linux 容器中运行。

REANA 集群后端

示例：使用 reana 后端异步运行来自 ATLAS Exotics Rome Workshop 2018 的 示例。

使用 reana 附加组件安装 recast-atlas

python -m pip install --upgrade 'recast-atlas[reana]' coolname

使用 REANA 集群进行认证（记得之后使用 eval $(recast auth destroy) 清理）

# Set these variables to your personal secret values
export RECAST_AUTH_USERNAME="<your RECAST auth username>"
export RECAST_AUTH_PASSWORD="<your RECAST auth password>"
export RECAST_AUTH_TOKEN="<your RECAST auth token>"

eval "$(recast auth setup -a ${RECAST_AUTH_USERNAME} -a ${RECAST_AUTH_PASSWORD} -a ${RECAST_AUTH_TOKEN} -a default)"
eval "$(recast auth write --basedir authdir)"

export REANA_SERVER_URL=https://reana.cern.ch
export REANA_ACCESS_TOKEN="<your RECAST access token>"

将 RECAST 工作流提交到 REANA 集群

reana_tag="reana-$(coolname 2)"
recast submit examples/rome --backend reana --tag "${reana_tag}"
# REANA_WORKON sets the workflow automatically
export REANA_WORKON="recast-${reana_tag}"

在 REANA 上监控工作流的状态

reana-client status
# or if REANA_WORKON not set
# reana-client status --workflow "<the created tag>"

在 examples/rome 示例中没有结果文件，但如果有的话，在工作流成功后可以下载结果

reana-client download --output-directory output
# or if REANA_WORKON not set
# reana-client download --workflow "<the created tag>" --output-directory output

清理环境变量中的个人信息公开

eval $(recast auth destroy)

在 LXPLUS9 上

ssh lxplus9.cern.ch
source ~recast/public/setup.sh
recast catalogue ls
recast run examples/rome