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.8.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.8-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.8-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.8-cp313-cp313-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

avica-0.3.1.8-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.8-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.8-cp312-cp312-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

avica-0.3.1.8-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.8-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.8-cp311-cp311-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

avica-0.3.1.8-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.8-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.8-cp310-cp310-macosx_11_0_arm64.whl (2.2 MB view details)

Uploaded CPython 3.10macOS 11.0+ ARM64

avica-0.3.1.8-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.8-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.8-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.8.tar.gz.

File metadata

  • Download URL: avica-0.3.1.8.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.8.tar.gz
Algorithm Hash digest
SHA256 5ccb3104c649df96c475e64ea6df49cb487bd47ba0fe3ec7e2a8ec0cdb7a76fb
MD5 30cb244c991c653fb1aefbceeeca13aa
BLAKE2b-256 13894a7db1534aaca99ab8574da3368eb67e43a243d5f3c6aeba640b8fbe0834

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8.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.8-cp313-cp313-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 d797918e842c9a61cc3592a4be15ecc44435e08255242b6b9d2512b4d6374235
MD5 5c813fe399898e22f768ae02cf9b29ae
BLAKE2b-256 64e5df561ac35bd131ee925cf4ecb92633302e8111d50db5e2ffd1e5725515d3

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 ffeca3dc0ca7bdfd8a3707aaff2dc9d6cf234c3c0a4b9435071022d802743c61
MD5 21300e4cb075274727a25a6c5a09f8cf
BLAKE2b-256 8be2b71f72eb96e5318fa6db1e46a8c7186454f23d7c2de83c4f63ed3eca17d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 3a23203195065500b2d7b1b552eb1c00b931c333c83966a78027f9803276905c
MD5 5bfda541c6beed253138f58ebebe43a4
BLAKE2b-256 c464e6536593f89dcb3589a6fbd1fda6b5e750dfc47726046ca411eddd3ef4d4

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp312-cp312-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 a47a42c0388e834caaaf8487baecea526556e88395b94b0e4dd51551d9ecfdee
MD5 25f1e8a210be7f973312dc125541b6c3
BLAKE2b-256 4f48de4ca4cd1c73389c750d6c061c7a908b5ebb150849a88b184a69cb0288e7

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 165236c5cfb336b22f232f7e90e3808aac97247a9d475b3cf14ca658b2200e5f
MD5 e9d0b2c2541a3513c04e4262b254bdd2
BLAKE2b-256 74d9dba48f76b95fe86e863011e389476ef27be498e831ab5bd122bdb31b4faa

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c421a7ec29876b88feb7c370bfdd19c1673189332fc79c6ca79a37131b9a323f
MD5 a735fe9a0e8718848d6db4c8910dd81d
BLAKE2b-256 c02d681b6d11c8487d3aa8812e25da4fa442e2dce23c25001a9842231b692ca7

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp311-cp311-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp311-cp311-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 d7aefcf658bcc222c13ff89c5868892c61553af2a3ce439fa08e74ff3c683183
MD5 f8f2d377e23a239417937dc7571ea497
BLAKE2b-256 e42098b23a8667c0ca5aebfca1f45b56b6fd0ba37ed9ac37b7d4e5baca08236a

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 89b8a2faa24322667a65f78c868bab75ac0286933761d9934af9da4cf7775897
MD5 6334a100d8700949e8a0d23aa2c9c051
BLAKE2b-256 ca8a24a5351f46db5a770e9abcaa6d1462b398416585c0a45aac2431c9eb672b

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 b3e9d8d577b4d0c3a0b0d458d135ff44c6ef4ab185539834ba486fc2a4b54387
MD5 5a54759bfbca34a7f96b537252af9164
BLAKE2b-256 1b67cf360b7a57900125c295890fb9766ebe4a81e95c55a173540048b1e32268

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp310-cp310-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp310-cp310-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 0b24d9f600cb3cef9f4d9f7f6230b9cc145682ac6a80de924c58dec8715de382
MD5 20efd2b2c7b647311ec0b776022d8982
BLAKE2b-256 d835ce15b129b6f26290d992842a76d26875022cd17b5bd5f879a213c0f4de05

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 73dbddc3142b897a31e5f80ec7af2efc1d0ba7b430301e13c5442415c7b21cc3
MD5 71baf2cd59143ad8be763d422e5cc0fa
BLAKE2b-256 64e8b95da3cfc0eb4630ed17a842c9d6b8fd4cdb76aa0b903023a5c3f27e1d71

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp310-cp310-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 bedb33428b1d6a2eb9f001d37007f2cee48aa6e6234806e1213989983647de57
MD5 a9bbc3d8ccb7c9354c933f4ac11c96bd
BLAKE2b-256 62bc7359c1691e9ba19bee54c687d9bd45e3299d0c1ee93a641630f9c5fbfac8

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp39-cp39-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp39-cp39-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 7d76f001301a05bad038c2ecb3e68a6689b294e2244521abe6f2ed2ba84a0712
MD5 59062a16095a30e0fb4091033fa22162
BLAKE2b-256 8a4c6c3562faf1071fc1e75412c5b009e7c11a41f2a63979427c89ba7038eae1

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 3eafe0e972959db79be7c3a601ca35be764081ca5c301fdc4e22b9d9b0dbfa3b
MD5 c5a3fb7f1c00c4dc1b9ffc5258d013f8
BLAKE2b-256 414df4aa927d087c7b0b6649d497ea1052576317ee99d08198a50bf3fd2b7d01

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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.8-cp39-cp39-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for avica-0.3.1.8-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d66dca44e85f83bc2501845f65d8256f00c2cdef1b29b533f4a9154c5a8cc3cb
MD5 73baf50f061e5ba5c2f927ebb851329c
BLAKE2b-256 a7ded082b88c0cd3bf68a845ce00b4021d8c47d1803f3ee58e0592a6006985ec

See more details on using hashes here.

Provenance

The following attestation bundles were made for avica-0.3.1.8-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

This release

0.3.1.8 This release

16 files

0.3.1.7

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