Skarabina

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

skarabina: a basic 1GC radio astronomy RFI flagger

Author: Tim Molteno (tim@elec.ac.nz)

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:

Install

pip install skarabina

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

Quick start

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

# Keep a subset of scans, then average
skarabina --ms raw.ms --scan 1,12,14 --flag-nan \
    --frequency-average-factor 8 --msout kept.ms --clobber

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

# Plot a gain table or an MS (casaplotms substitute, arm64-friendly)
skarabina-plotms --ms raw.ms --plotfile amp_vs_time.png --overwrite

--field-of-view (flagging/summary) and --image-fov (analysis) both take the field of view as a full width, so the same value can be passed to both. The summary's fringe-rotation limit uses the distance from the phase centre to the edge, i.e. half of it.

Build

Install uv, then:

uv sync
uv build

Stimela

_include:
    - (skarabina_cargo):
        - 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

Metadata

Release files for skarabina 1.0.19

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for skarabina 1.0.19
File	Size	Uploaded
skarabina-1.0.19.tar.gz	515.4 kB	Oct 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for skarabina 1.0.19
File	Interpreter	ABI	Platform	Reset
skarabina-1.0.19-py3-none-any.whl 164.1 kB Oct 9, 2026	Python 3	none	any	Details

Total release size: 679.6 kB

Release files / skarabina-1.0.19.tar.gz

Download URL	skarabina-1.0.19.tar.gz
Size	515.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`97ad169d6852384228a97f6af921e31f8de66125c77dbae1ac6f79f15cb34028`
BLAKE2b-256 checksum How to use checksums	`bdf3edad6950de075c350415cdafbe58f10f52750a95b6acfe468caaa383796b`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/skarabina
Publishing commit: github.com/tmolteno/skarabina/tree/13f23b11398608ff7f80d9d0a4cc13b55ad0e59e

Workflow

Publishing configuration: github.com/tmolteno/skarabina/blob/13f23b11398608ff7f80d9d0a4cc13b55ad0e59e/.github/workflows/deploy_module.yaml
Publishing logs: github.com/tmolteno/skarabina/actions/runs/37984388742/attempts/1

Artifact

Subject: skarabina-1.0.19.tar.gz
SHA-256 checksum: 97ad169d6852384228a97f6af921e31f8de66125c77dbae1ac6f79f15cb34028 Verifying attestations

Release files / skarabina-1.0.19-py3-none-any.whl

Download URL	skarabina-1.0.19-py3-none-any.whl
Size	164.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`29e4d702a58ac679c300eee2273680d5625894e4c7cc96ed2db2410ee970cd10`
BLAKE2b-256 checksum How to use checksums	`cd332b01fd1dfdb0da26503e3fd86015a52ae41a157696a52abeb7eecc3b91d6`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/tmolteno/skarabina
Publishing commit: github.com/tmolteno/skarabina/tree/13f23b11398608ff7f80d9d0a4cc13b55ad0e59e

Workflow

Publishing configuration: github.com/tmolteno/skarabina/blob/13f23b11398608ff7f80d9d0a4cc13b55ad0e59e/.github/workflows/deploy_module.yaml
Publishing logs: github.com/tmolteno/skarabina/actions/runs/37984388742/attempts/1

Artifact

Subject: skarabina-1.0.19-py3-none-any.whl
SHA-256 checksum: 29e4d702a58ac679c300eee2273680d5625894e4c7cc96ed2db2410ee970cd10 Verifying attestations