Skip to main content

PyPI - Downloads Read the Docs GitHub Release GitHub Last Commit

AVICA: Automated VLBI pipeline in CASA

Accepted for publication in Astronomy & Astrophysics journal.

asciicast

Full documentation: https://avica.readthedocs.io/en/latest/

Contents

Installation

Requirements:

  • Ubuntu 18.04+, Debian 10+, or RHEL/CentOS 8+
  • Python >= 3.9

The avica package is publicly available on PyPI. Use uv or pipx for an isolated command-line installation.

Recommended installation

Using uv:

uv tool install avica --python 3.10

Using pipx:

pipx install avica

Using pip:

pip install avica

If you install with pip, use a virtual environment unless you already manage Python packages another way.

Manual installation

Clone the repository and install it locally:

git clone https://github.com/avikhagol/avica.git
cd avica/
pip install .

Usage

The pipeline calibration steps rely on rPicard. Follow the rPicard setup instructions first. After rPicard is configured, AVICA only needs a minimal configuration file to get started; see Configuration.

Pipeline

Run the default pipeline:

avica pipe run --fitsfilenames <file1.uvfits,file2.uvfits> --target <source-name>

The default pipeline executes these steps:

  • preprocess_fitsidi
  • fits_to_ms
  • phaseshift
  • avica_avg
  • avicameta_ms
  • avica_snr
  • avica_fill_input
  • avica_split_ms
  • rpicard

You can pass one or more step names to run only part of the pipeline:

avica pipe run preprocess_fitsidi fits_to_ms --fitsfilenames <file.uvfits>

Common options:

Option Description
--f, --fitsfilenames Comma-separated FITS-IDI file names.
--t, --target Selected field or source name.
--configfile Configuration file containing key=value entries. Defaults to avica.inp.
--help Show the full command help.

Manipulating FITS-IDI

Check FITS-IDI files for known issues:

avica fitsidi_check <file.uvfits>

Useful options:

Option Description
--fix, --no-fix Apply available fixes. Defaults to --no-fix.
--desc, --no-desc Show issue descriptions. Defaults to --no-desc.
--help Show the full command help.

Example output:

avica fitsidi_check VLBA_VSN005412_file3.uvfits
+--------------------+---------+-------+-------+----------------+----------+
| hdu                | fixable | total | fixed | problem_code   | affected |
+==========================================================================+
| ARRAY_GEOMETRY     | 0       | 8     | 0     | []             | []       |
| ANTENNA            | 0       | 16    | 0     | []             | []       |
| FREQUENCY          | 0       | 8     | 0     | []             | []       |
| PHASE-CAL          | 0       | 12    | 0     | []             | []       |
| PRIMARY            | 1       | 10    | 0     | ["extra_byte"] | [""]     |
| SOURCE             | 0       | 8     | 0     | []             | []       |
| FLAG               | 0       | 12    | 0     | []             | []       |
| UV_DATA            | 0       | 8     | 0     | []             | []       |
| GAIN_CURVE         | 0       | 8     | 0     | []             | []       |
| SYSTEM_TEMPERATURE | 0       | 8     | 0     | []             | []       |
+--------------------+---------+-------+-------+----------------+----------+

List observation information:

avica listobs <file.uvfits>

Configuration

The pipeline configuration is a key=value file. By default, AVICA looks for avica.inp in the current directory. See the example configuration for a minimal setup.

Pass a custom configuration file with --configfile:

avica pipe run --configfile <path/to/config/file>

If --configfile is not provided, AVICA uses avica.inp by default.

To store defaults persistently, create ~/.avica/avica.inp from an existing file:

avica pipe config --default --inpfile <path/to/avica.inp>

You can also set default values directly:

avica pipe config --default key=value key2=value2 key3=value3

To set global defaults in AVICA's installed directory, use --global in the same way:

avica pipe config --global --inpfile <path/to/avica.inp>
avica pipe config --global key=value key2=value2 key3=value3

Attribution

When using AVICA, please add a link to this repository in a footnote.

Acknowledgement

AVICA was developed within the "Search for Milli-Lenses" (SMILE) project. SMILE has received funding from the European Research Council (ERC) under the HORIZON ERC Grants 2021 programme (grant agreement No. 101040021).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

avica-0.3.1.7.tar.gz (1.9 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

avica-0.3.1.7-cp313-cp313-musllinux_1_2_x86_64.whl (3.4 MB view details)

Uploaded CPython 3.13musllinux: musl 1.2+ x86-64

avica-0.3.1.7-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

avica-0.3.1.7-cp313-cp313-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

avica-0.3.1.7-cp312-cp312-musllinux_1_2_x86_64.whl (3.4 MB view details)

Uploaded CPython 3.12musllinux: musl 1.2+ x86-64

avica-0.3.1.7-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

avica-0.3.1.7-cp312-cp312-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

avica-0.3.1.7-cp311-cp311-musllinux_1_2_x86_64.whl (3.4 MB view details)

Uploaded CPython 3.11musllinux: musl 1.2+ x86-64

avica-0.3.1.7-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

avica-0.3.1.7-cp311-cp311-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

avica-0.3.1.7-cp310-cp310-musllinux_1_2_x86_64.whl (3.4 MB view details)

Uploaded CPython 3.10musllinux: musl 1.2+ x86-64

avica-0.3.1.7-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

avica-0.3.1.7-cp310-cp310-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

avica-0.3.1.7-cp39-cp39-musllinux_1_2_x86_64.whl (3.4 MB view details)

Uploaded CPython 3.9musllinux: musl 1.2+ x86-64

avica-0.3.1.7-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view details)

Uploaded CPython 3.9manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

avica-0.3.1.7-cp39-cp39-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded CPython 3.9macOS 11.0+ ARM64

File details

Details for the file avica-0.3.1.7.tar.gz.

File metadata

  • Download URL: avica-0.3.1.7.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for avica-0.3.1.7.tar.gz
Algorithm Hash digest
SHA256 c99d92d9b71a5f40dc12a3c8934fbd706e7376b664213db9e257b150271e0ef9
MD5 5da64b4f69a53748b8c743daacb6fd2c
BLAKE2b-256 8aca287994eeac8c3fd143c39a10f6b285fafe07ebf0e06247b4a08f8b55f3b5

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7.tar.gz:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp313-cp313-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 956ee384822e5d10cacb2bee6c7e27dae19b7f3c3cbb3a51ef482afaee8b5846
MD5 9e23d56bb754473ae10181a8f2de9a16
BLAKE2b-256 bddc3178489b86a45c940ca6e66a25bd8af970059f7acb3231db097b337d14f7

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp313-cp313-musllinux_1_2_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 10c9642e2859fd7debe983ea0fb564c5afe07779ccc5d8ab2ce6690a90fb721e
MD5 a88798d467171a8b61b6b60206a317fa
BLAKE2b-256 d21478f2a5f94d0c92c4a6167e1d0f840d3609b43596751847199cd9900e810f

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 385abd5874a47eac8662e3442a4aa83134363e45b08a1a9786393f017a6439e0
MD5 b977d054a50d6d94c61ed379a6c5d32d
BLAKE2b-256 9d9876c92969e33cc56730986548aaa10098450fb21623eec2240084594663b6

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp312-cp312-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 53abb4e60faf3da178910fc42751fe86530840826c9b7703593cf1a1c107c767
MD5 d8980c190df7d0fa63c36471edaf6873
BLAKE2b-256 981fb1de9a16e37f912910784fa6faa3a99f0783a0096b7d3860a88cd9b1be52

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp312-cp312-musllinux_1_2_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 2f39dbb9e0f784f741b489dbed97b2e044a0f2629aae60601a1e68f635af2ca4
MD5 040173d7bb208852c9553c6f5daea4a7
BLAKE2b-256 9dd6a918cbdf881d1ca939bf29e98d675ab16f65cfb3a82bbb1a5a5a2f7e42e1

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 296ab6682e011ad6ba7c4158760ff2ae7388ae1149becea011bb1b52e3729044
MD5 16025bd9e098ab3feb807e6ce7cc65da
BLAKE2b-256 b8d1074dcb5d4cc545e0f6a349149134261ab7bbe0965915968dd9a2ae793be6

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp311-cp311-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp311-cp311-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 4f0ad8b5eedb9a7ed645767a148cf8c532061e3ed69d94d7680f0813453febf8
MD5 bc692c92cc713f8c7a44a5c95301d968
BLAKE2b-256 5168405e5874b3fd6e0db8bfed3815f4c7d348ac2d8639fad9a1ff96d42482c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp311-cp311-musllinux_1_2_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 286b31c0f4663f44fc7b9f96c5a5e57f4429e21e57ecd3506e7eaab634d03058
MD5 bf9577d66a9f604e680a3b728319b055
BLAKE2b-256 7397dba4ed7226d399336b78ee03bd5e99dfa1bde219e235895e254f0b07227f

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a2add0d30a1fa6af292759f22283c4b90c4d5dc46da8cff94ded29b493bab4f5
MD5 9597270d015589c0dfb5c69d712e992c
BLAKE2b-256 e06bec6cace9acb187b72f7dbf7564f0a34bbac2e999e88c5918f5d84f497b9b

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp310-cp310-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp310-cp310-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 4719ed6a1de3c3148c5bd14ec1f65ba6a2c2eda8f1d11b84fea8c0fba75d91e1
MD5 f8c19c153584358dee0d3a0f7180ec92
BLAKE2b-256 4ab9e71042a3e5d15bf1e81312ca851202a4fa36acc84c88d1fe641744a7d6a3

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp310-cp310-musllinux_1_2_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 db26b30e5654611e5ee5b46bb557212c723e08ca315d1624e3e9efbc78258256
MD5 683935ccc7a4097b124be8c361f73d5e
BLAKE2b-256 755455275b43aff6772de107bf9b54db128ef26b1477cae2afe99f54d71e765d

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 66d165a8a2a730cfb1300e0e219aff08a4b748961bcca9b732a3ede49d4bc9a9
MD5 f2b18dc3e6373e4e9bf525ef64957b69
BLAKE2b-256 c41446edd1022b0ebac66bd26da41e36503308afd9830575839a19bb7970288b

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp310-cp310-macosx_11_0_arm64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp39-cp39-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp39-cp39-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 537bac3a91567ed23b90e68b0442a6668b8086981f4081f243156e73a9d78353
MD5 a0e07d17fcdd6d31d10b3c37d70ef93e
BLAKE2b-256 da886a09c29c2a415f283cf36471d491df7420f593ca2b67a616d20af34b6991

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp39-cp39-musllinux_1_2_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 d8679def72ff565be8245f5c439adc7b26e349223b13413acc7c0c349ddfd7d9
MD5 f27739317556e948f52eeb2d3c50bb62
BLAKE2b-256 eb59bd7a47e09803019281418cb08e41c77ce6140ea2429a553d853d704ae692

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avica-0.3.1.7-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.7-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 78a9bb82c103de92477e874e84f860fd8171d54f6ecedc2d3c7c8d3ab8058cd1
MD5 ce1a25d36ab361d57e85631043e1dac7
BLAKE2b-256 a71d868fcb1fa3c5e6a29e715f0107a87fc3387cc048811129c244e3babd4b3a

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.7-cp39-cp39-macosx_11_0_arm64.whl:

Publisher: build_wheels.yml on avikhagol/avica

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.3.1.10

16 files

0.3.1.9

16 files

0.3.1.8

16 files

This release

0.3.1.7 This release

16 files

0.3.1.6

16 files

0.3.1.5

16 files

0.3.1.4

16 files

0.3.1.3

16 files

0.3.1.2

16 files

0.3.1.1

16 files

0.3.1.0

16 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page