skarabina 0.6.1

Skarabina (dungbeetle): An all purpose 1GC flagger

Skarabina

 =,                .=
=.|      ,---.      |.=
=.|   "-(:::::)-"   |.=
   \\__/`-.|.-'\__//
    `-| .::| .::|-'      Pillendreher
     _|`-._|_.-'|_       (Scarabaeus sacer)
   /.-|    | .::|-.\
  // ,| .::|::::|. \\
 || //\::::|::' /\\ ||
 /'\|| `.__|__.' ||/'\
^    \\         //    ^
     /'\       /'\
    ^             ^

skarabina: a basic 1GC radio astronomy RFI flagger

Author: Tim Molteno ([e-mail])

Intended to reduce I/O costs by performing the standard flagging during 1GC efficiently, and with low memory requirements. Skarabina can also do averaging to reduce data volume, and measurement set analysis to recommend image size.

Documentation

See doc/ for full documentation:

• Usage & CLI reference
• Time & frequency averaging
• Measurement set analyzer
• Changelog

Install

pip install skarabina

See INSTALL.md for detailed instructions, including aarch64 / NVIDIA DGX Spark setup.

Quick start

# Flag and clean
skarabina --ms raw.ms --flag-nan --flag-uv-above 4000 \
    --time-average-factor 3 --optimize --msout clean.ms --clobber

# Analyze
skarabina-analyze --ms raw.ms --image-fov 2.5

Build

Install uv, then:

uv sync
uv build

Stimela

_include:
    - (skarabina):
        - skarabina.yml

my-recipe:
    info: "Print a flagging summary using skarabina"
    inputs:
        ms: MS
    steps:
        flag-summary:
            cab: skarabina
            params:
                ms: =recipe.ms
                summary: true