llama flags

Set flags for an event directory from the command line. Only flags specified with --flags will be changed. To print current flags without changing values, provide --flags with no arguments.

usage: llama flags [-h] [--dry-run-dirs] [--downselect DOWNSELECT]
                   [--flags [FLAGNAME=value [FLAGNAME=value ...]]]
                   [--flag-presets] [--dry-run-flags]

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. Any omitted flags will take on the default values in DEFAULT_FLAGS. If you don’t specify --flags, 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’, ‘ICECUBE_UPLOAD’: ‘false’, ‘ONLINE’: ‘true’, ‘MANUAL’: ‘false’, ‘BLINDED_NEUTRINOS’: ‘false’}); the full set of allowed values is (‘true’, ‘false’) for MANUAL, (‘true’, ‘false’) for UPLOAD, (‘true’, ‘false’) for BLINDED_NEUTRINOS, (‘true’, ‘false’) for ONLINE, (‘true’, ‘false’) for VETOED, (‘true’, ‘false’) for ICECUBE_UPLOAD, and (‘test’, ‘observation’) for ROLE.


Print available flag presets.


Print flags parsed by the CLI and exit.

Default: False

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”), ints (if they can be parsed as such), floats (if they can be parsed as such), 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.