This release is a pre-release and may not be stable for production use.
RECAST for ATLAS
ATLAS tools to facilitate integration of ATLAS analyses into RECAST
Getting Started
Install
recast-atlas is installable from PyPI using pip inside of your Python virtual environment
python -m pip install recast-atlas
CLI API
The 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
Running RECAST
recast-atlas aims to enable both local execution as well as asynchronous execution on a REANA cluster.
Docker backend
Example: Run the example from the ATLAS Exotics Rome Workshop 2018 using the (default) docker backend.
Install recast-atlas from PyPI
python -m pip install --upgrade recast-atlas coolname
Submit the RECAST workflow, orchestrated in a recast/recastatlas Docker container
recast run examples/rome --backend docker --tag "docker-$(coolname 2)"
Local backend
Example: Run the example from the ATLAS Exotics Rome Workshop 2018 using the local backend.
Install recast-atlas with the local extra
python -m pip install --upgrade 'recast-atlas[local]' coolname
Submit the RECAST workflow to run locally
PACKTIVITY_DOCKER_CMD_MOD="-u root" recast run examples/rome --backend local --tag "local-$(coolname 2)"
The local backend orchestrates the workflow graph locally, but note that the different workflow steps still run in Linux containers.
REANA cluster backend
Example: Asynchronously run the example from the ATLAS Exotics Rome Workshop 2018 using the reana backend.
Install recast-atlas with the reana extra
python -m pip install --upgrade 'recast-atlas[reana]' coolname
Authenticate to use the REANA cluster (remember to clean up later with 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>"
Submit the RECAST workflow to the REANA cluster
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}"
Monitor the state of the workflow on REANA
reana-client status
# or if REANA_WORKON not set
# reana-client status --workflow "<the created tag>"
Download the results after the workflow succeeds
reana-client download statanalysis --output-directory output
# or if REANA_WORKON not set
# reana-client download statanalysis --workflow "<the created tag>" --output-directory output
Clean up the environment of personal information in environmental variables
eval $(recast auth destroy)
On LXPLUS9
ssh lxplus9.cern.ch
source ~recast/public/setup.sh
recast catalogue ls
recast run examples/rome
3 maintainers
Metadata
3 maintainers
Release files for recast-atlas 0.5.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| recast_atlas-0.5.0a1.tar.gz | 22.5 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| recast_atlas-0.5.0a1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 54.0 kB
Release files / recast_atlas-0.5.0a1.tar.gz
| Download URL | recast_atlas-0.5.0a1.tar.gz |
|---|---|
| Size | 22.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ad8420ccddd76ee35e5bf9499d9acc3712e933a1e6813aa631abb8c938cfbc19
|
|
BLAKE2b-256 checksum How to use checksums |
be58be5e26d52ba5dc7010d115038d26cfebc4933364c002cbf5902d5735e366
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logRelease files / recast_atlas-0.5.0a1-py3-none-any.whl
| Download URL | recast_atlas-0.5.0a1-py3-none-any.whl |
|---|---|
| Size | 31.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c0e7cab5378690e982597f1f3c2ae8066b47c914bd178a7b863a5ea131ff65c5
|
|
BLAKE2b-256 checksum How to use checksums |
6d856a681b01a7040117083847d4b90e676f817227dd6634ec15103dd1df73c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logSecurity for recast-atlas 0.5.0a1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for recast_atlas-0.5.0a1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
