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.21

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.21
File	Size	Uploaded
skarabina-1.0.21.tar.gz	521.5 kB	Oct 11, 2026	Details

Built distribution (wheel)

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

Total release size: 686.7 kB

Release files / skarabina-1.0.21.tar.gz

Download URL	skarabina-1.0.21.tar.gz
Size	521.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`d0972fd0d23f2477daa7e3c161a50c3d19bf1bf8c363ed78ebdb522beabddcd9`
BLAKE2b-256 checksum How to use checksums	`3ad459777d6dd2d30239c59edbb43f0dda26c735ec4ba5e522c1377477201afb`
Upload date	Oct 11, 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/934247f487e5f3d6ee08b0cfc954f3e5eb302abd

Workflow

Publishing configuration: github.com/tmolteno/skarabina/blob/934247f487e5f3d6ee08b0cfc954f3e5eb302abd/.github/workflows/deploy_module.yaml
Publishing logs: github.com/tmolteno/skarabina/actions/runs/38127585204/attempts/1

Artifact

Subject: skarabina-1.0.21.tar.gz
SHA-256 checksum: d0972fd0d23f2477daa7e3c161a50c3d19bf1bf8c363ed78ebdb522beabddcd9 Verifying attestations

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

Download URL	skarabina-1.0.21-py3-none-any.whl
Size	165.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`de4e828fa2286ca7a0b6b2ea20031c62f7017b35112d2cc453b3fad8e1e72c28`
BLAKE2b-256 checksum How to use checksums	`0c6f9ecf6b050a1829dea811b4ae8b0d387185225af7af6b00629bc5375b0a79`
Upload date	Oct 11, 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/934247f487e5f3d6ee08b0cfc954f3e5eb302abd

Workflow

Publishing configuration: github.com/tmolteno/skarabina/blob/934247f487e5f3d6ee08b0cfc954f3e5eb302abd/.github/workflows/deploy_module.yaml
Publishing logs: github.com/tmolteno/skarabina/actions/runs/38127585204/attempts/1

Artifact

Subject: skarabina-1.0.21-py3-none-any.whl
SHA-256 checksum: de4e828fa2286ca7a0b6b2ea20031c62f7017b35112d2cc453b3fad8e1e72c28 Verifying attestations