Tool to locally run tests for AnalysisProductions
Project description
LbAPLocal
LbAPLocal is the python library for running offline tests for the LHCb AnalysisProductions framework.
Usage
LbAPLocal is installed by default with the LHCb environment on lxplus. For users on external clusters, one can source the LHCb environment from CVMFS to get setup: source /cvmfs/lhcb.cern.ch/lib/LbEnv
After installing, LbAPLocal can be run from the command line with the following options:
Usage: lb-ap [OPTIONS] COMMAND [ARGS]...
Command line tool for the LHCb AnalysisProductions
Options:
--version
--help Show this message and exit.
Commands:
versions List the available tags of the Analysis Productions...
checkout Clean out the current copy of the specified production and...
clone Clone the AnalysisProductions repository and do lb-ap...
list List the available production folders by running 'lb-ap list'
list-checks List the checks for a specific production by running lb-ap...
render Render the info.yaml for a given production
validate Validate the configuration for a given production
test Execute a job locally
check Run checks for a production
debug Start an interactive session inside the job's environment
reproduce Reproduce an existing online test locally
parse-log Read a Gaudi log file and extract information
To update an existing production:
$ lb-ap checkout <version> <working_group> <production> <branch>
where version
is the latest version of AnalysisProductions corresponding to production
, working_group
is the working group the production belongs to, production
is the production you want to update and branch
is the name of the branch you want to work on.
If you don't yet have a local copy of AnalysisProductions:
$ lb-ap clone <version> <working_group> <production> <branch> <clone_type>
where version
, working_group
, production
and branch
are defined as above. clone_type
can be either ssh
, https
or krb5
, by default it is ssh
.
To see which versions of the repository are available for a given production:
$ lb-ap versions B2OC B02DKPi
The available versions for B02DKPi are:
v0r0p1674088
v0r0p1735460
.
.
.
To see which productions are available locally:
$ lb-ap list
The available productions are:
* MyAnalysis
To see which jobs are available for a given production:
$ lb-ap list MyAnalysis
The available jobs for MyAnalysis are:
* My2016MagDownJob
* My2016MagUpJob
To see which checks are defined for a given production:
$ lb-ap list-checks MyAnalysis
The checks defined for MyAnalysis are:
* MyRangeCheck (type: range)
* MyOtherRangeCheck (type: range)
* MyNumEntriesCheck (type: num_entries)
To see which checks are used for a job within a given production:
$ lb-ap list-checks MyAnalysis My2016MagDownJob
The checks defined for MyAnalysis that are required by My2016MagDownJob are:
* MyRangeCheck (type: range)
* MyNumEntriesCheck (type: num_entries)
To render the templating in info.yaml
for a given production:
$ lb-ap render MyAnalysis
To validate the configuration of a given production:
$ lb-ap validate MyAnalysis
Rendering info.yaml for MyAnalysis
YAML parsed successfully
YAML validated successfully
To run a test of a job interactively:
$ lb-ap debug MyAnalysis My2016MagDownJob
Welcome to analysis productions debug mode:
The production can be tested by running:
gaudirun.py -T '$ANALYSIS_PRODUCTIONS_DYNAMIC/Lb2Lll/MC_2017_MagDown_Lb2PsiL_mm_strip_autoconf.py' '$ANALYSIS_PRODUCTIONS_BASE/Lb2Lll/stripping_seq.py' prodConf_DaVinci_00012345_00006789_1.py
[DaVinci v45r5] output $
To test a job non-interactively:
$ lb-ap test MyAnalysis My2016MagDownJob
Success! Output can be found in xxxxxxxxxxxx
For both interactive and non-interactive testing, when testing a job that depends on another job to provide the input file the dependent job will be tested first and its output passed to the requested job. If the dependent job has already been run the location of its output can be passed to the requested job by appending -i <output_file_path>
to lb-ap test <production_name> <job_name>
.
To test a job on a specific input file:
$ lb-ap test MyAnalysis My2016MagDownJob -i InputFileLocation
Success! Output can be found in xxxxxxxxxxxx
InputFileLocation can be either an LFN or a path to a local file. This is also valid for the debug command.
To run only the checks for a job (non-interactively, requiring the output from an earlier successful test
command):
$ lb-ap check MyAnalysis My2016MagDownJob local-tests/path/to/output/OUTPUT_NTUPLE.ROOT
All checks passed! Any output can be found in local-tests/path/to/output/checks
To run only the checks for a job but saving the output to a different location (non-interactively, requiring the output from an earlier successful test
command):
$ lb-ap check MyAnalysis My2016MagDownJob local-tests/path/to/output/OUTPUT_NTUPLE.ROOT another/file/path
All checks passed! Any output can be found in another/file/path
To read a Gaudi log file and extract information:
$ lb-ap parse-log Job.log
Summary of log messages in: Job.log
Found 2659 ERROR messages
* 2649 instances of "*** Flag container MC/TrackInfo not found."
* 9 instances of "HltSelReportsDecoder:: Failed to add Hlt selection name Hlt2RecSummary to its container "
* 1 instances of "HltSelReportsDecoder:: The ERROR message is suppressed : ' Failed to add Hlt selection name Hlt2RecSummary to its container '"
Found 61 WARNING messages
* 7 instances of "TupleToolBremInfo:: TupleToolBremInfo requires fullDST - BremP and BremOrigin might not be reliable (Multiplicity is OK)"
and 54 others (50 unique), pass "--suppress=0" to show all messages
Errors have been detected!
* Lines: 3275, 3277, 3279, 3281, 3283 and 17 others
This message indicates the location specified for the information being accessed by
RelatedInfo does not exist. It is likely that either:
* The location specified is incorrect, try looking for it with dst-dump.
* The given information was never stored for that candidate, in which case the use of
RelatedInfo should be removed.
General explanations
* Line: 6318
Histograms are not being saved as no filename has been specified for storing them. This
message is harmless and normally ignored.
Error: Found issues in log
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for LbAPLocal-0.7.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 586a207d2bede12f2c59ffa9b57decc21534193e28aabccf8a8c3b59915b4444 |
|
MD5 | 7cdab751b83519d9eae5d363528eea33 |
|
BLAKE2b-256 | 8d9f3bc1b81319983f25761ec92640202bdde65a785c9cfbfb217b1270ca59e9 |