Console output and banners

SET-ANUBIS banner

The public facade emits a compact SET-ANUBIS banner at most once per Python process. The default auto mode displays it only when stdout is an interactive terminal. This keeps CI logs and redirected batch output clean while retaining a clear identity in ordinary command-line use.

The mode is controlled by SETANUBIS_BANNER:

auto

Display the banner only in an interactive terminal. This is the default.

always

Display the banner even when stdout is redirected.

never

Disable the banner.

The public helper can also request it explicitly:

from setanubis import show_banner

show_banner(force=True)

The process-level guard prevents duplicate output when both setanubis and SetAnubis imports are used in the same analysis. The banner also identifies Théo Reymermier and Paul Swallow, reports whether the optional compiled Pythia binding is available in the active environment, and reminds users to cite the current ANUBIS proceedings contribution together with the corresponding Zenodo software release.

The 1.0.0 banner embeds the versioned Zenodo DOI 10.5281/zenodo.21462101. SETANUBIS_ZENODO_DOI can override this value for development builds and later releases.

FastJet banner

FastJet prints a citation and licence banner the first time a clustering sequence is created. SET-ANUBIS suppresses that console output by default so that notebooks, batch jobs and CI logs remain concise.

Users can restore the upstream FastJet banner explicitly:

export SETANUBIS_FASTJET_BANNER=1

or configure a clustering instance directly:

from setanubis import JetClustering, JetClusteringConfig

clustering = JetClustering(
    JetClusteringConfig(show_banner=True)
)

This option only controls console output. It does not alter the jet algorithm, the resulting jets, or the requirement to cite FastJet in scientific work.