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]
                   [--print-downselections]
                   [--flags [FLAGNAME=value [FLAGNAME=value ...]]]
                   [--flag-presets] [--dry-run-flags]
                   [run]

Named Arguments

--flags

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({‘UPLOAD’: ‘false’, ‘ROLE’: ‘test’, ‘ICECUBE_UPLOAD’: ‘false’, ‘VETOED’: ‘false’, ‘MANUAL’: ‘false’, ‘ONLINE’: ‘true’, ‘BLINDED_NEUTRINOS’: ‘false’}); the full set of allowed values is (‘true’, ‘false’) for UPLOAD, (‘true’, ‘false’) for BLINDED_NEUTRINOS, (‘true’, ‘false’) for ICECUBE_UPLOAD, (‘test’, ‘observation’) for ROLE, (‘true’, ‘false’) for MANUAL, (‘true’, ‘false’) for VETOED, and (‘true’, ‘false’) for ONLINE.

--flag-presets

Print available flag presets.

--dry-run-flags

Print flags parsed by the CLI and exit.

Default: False

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

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/*

--dry-run-dirs

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

Default: False

--downselect

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-downselections

Print available downselections.