llama flags

Set flags for an event directory from the command line. Query for events based on the llama.run they belong to as well as a glob-pattern matching desired eventid values.

usage: llama flags [-h] [--dry-run-dirs] [--downselect DOWNSELECT]
                   [--print-downselections PRINT_DOWNSELECTIONS]
                   [--flags [FLAGNAME=value [FLAGNAME=value ...]]]

Named Arguments


A single flag preset (see: llama.flags) to use (print choices with --flag-presets) in --outdir OR individual flag settings in the format FLAGNAME=value. YOU SHOULD PROBABLY USE A PRESET rather than individual flag settings. If you don’t specify a flag preset or a set of flags manually, you’ll be prompted to provide one; just provide --flags with no arguments to accept the default/existing flags. Flags are used to set overall behaviors for an event and set intentions, e.g. to mark an event as “ONLINE” and therefore allowed to communicate with partner web APIs and send out products and alerts. Flag name options and default values (for new events) are FlagPreset({‘VETOED’: ‘false’, ‘ROLE’: ‘test’, ‘UPLOAD’: ‘false’, ‘BLINDED_NEUTRINOS’: ‘false’, ‘MANUAL’: ‘false’, ‘ONLINE’: ‘true’, ‘ICECUBE_UPLOAD’: ‘false’}); the full set of allowed values is (‘test’, ‘observation’) for ROLE, (‘true’, ‘false’) for BLINDED_NEUTRINOS, (‘true’, ‘false’) for ONLINE, (‘true’, ‘false’) for ICECUBE_UPLOAD, (‘true’, ‘false’) for MANUAL, (‘true’, ‘false’) for UPLOAD, and (‘true’, ‘false’) for VETOED.


Print available flag presets.

filter runs and events (see: ``llama.run``)


A pattern specifying a list of directories to update of the form /run/directory/event*glob. See end of llama run -h documentation for details. (default: /root/.local/share/llama/current_run/*


Print the runs and event directories that would be affected and exit without taking further action.

Default: False


Arguments to pass to the downselect method of runs selected by the run argument (note that eventid_filter is already implicitly set by the glob pattern specified in run). Arguments will only be parsed as booleans (if they equal “True” or “False”) or strings and should be separated by commas, e.g. --downselect manual=False,fhnameexists=PAstro. Omit a list of downselections or provide an empty string to specify no further downselections beyond the one implied by the run argument. (default: None)


Print available downselections.