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

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.12macOS 11.0+ ARM64

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

Uploaded CPython 3.11macOS 11.0+ ARM64

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

Uploaded CPython 3.10macOS 11.0+ ARM64

avica-0.3.1.9-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.9-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.9-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.9.tar.gz.

File metadata

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

File hashes

Hashes for avica-0.3.1.9.tar.gz
Algorithm Hash digest
SHA256 0f948f90b6e8a69da988d74e571b95ed3ecab374fb09bcf97d0bda8622de758c
MD5 57d95db659b083ef949b34b054387fbb
BLAKE2b-256 6f050f3323ad606cf8bbff19d1076de47765a7f3f00162e7eb91789e3c8de8f7

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 72c760ce13a1a58f0c572ad0087ced216c670c6e3d7df7e6e259d10fb6fbd2b5
MD5 e458b98a4fc8b15271c47d60c3048f15
BLAKE2b-256 b384fbffcedaec6ebf2ca51476f6a6b97a8bd96fee62b56cd9b1c7ef21fd4c9f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 fcd794c7e9ab5ba265ff31d21cbd893b1792ee9050c20919b547b7e0152dd5f0
MD5 c275d0aaeac002b72a6a2b4313200bce
BLAKE2b-256 218972cb8b1d497960f225ecf5f86ba78a7058f1c6eb067864eb42b52b49d032

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 f7203ab7da53bc2e5ef113b206ef449426cd6f9851c2fb454b2c17303bc8b596
MD5 3a511bdf867220798b9441ef20cd5d32
BLAKE2b-256 c56f6add14323f381ca2f439b05294235ab585f08213d9cef9774e20f42813cb

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 1044325ccb89cf8c8d03a40e986a89a0e55838215646858dcd790a3869790aa9
MD5 20a89a075a8c39dbb053b644969e9cf1
BLAKE2b-256 3182981ba72e63aea909860a080555fdef2b786ff4fda26fdab783bf8d315a7a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 786defbbeb14524d6521916318be636c179be503586c0e6c8f86e1fd4672c199
MD5 0a737620f875fd17ba65615dc145be4e
BLAKE2b-256 9232acd02861505b2f21c2e4b456a8e084a85154a9f3d31d826c8a704db4e33a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 32e5ed95d65cc2b0de849846b9d0bd309b408ddf59c303b05a6f7069c19164bb
MD5 ac5389c5accb285dc12d716af4eb0ba0
BLAKE2b-256 87f72cf20408b8a27a5af279d2b983abdb0f0dd5433723e9a5d9a379f3caba8c

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp311-cp311-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 78b260e9745d838c303fe764089176f734c4375991d2f61383e03b9956aaae30
MD5 fea183847eae194cbfecc1c7ae8872c5
BLAKE2b-256 b24c133d11f798c95f950466097947b1a2a7f877224e75064e9a30364cb290e8

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 73c51c225399c747ed6e0ae8405643c0f593682bb0cdeabcd27324d4514d3dc9
MD5 d4222a0aa3810cfde924445ebebef073
BLAKE2b-256 4bde81accba1a575ec37d3e9c72d2d606ae7feb3bd709ab8a9cf7a2cf66e375a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7a770583e398928b33a36a45122c21dc6066496caa53756fb977873a828dc9d4
MD5 3960856492798b499e0fceea85796418
BLAKE2b-256 eb2bf95eaba6c849e967d908f27a548ce99025ded7321178b87683e3ff25291a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp310-cp310-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 8a6abc01b94bc1d5c939f833928b5fd789ef2c0aa42bb2dbae04160455023630
MD5 120149d52188602f03feace8263ff961
BLAKE2b-256 60ea42404fb524c4eafbb0d0cf796dbe9eb2ae964dce6c268fffca7cbfac5ab6

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 b9d78ae1901ebdb6f082ad497662816802bc4460f9710e8b1692a1f4ef2609b9
MD5 3cc0f76671ada49e781513f2af4b90c4
BLAKE2b-256 56f939a19feac7e973ac58892956b3a2aab52b17aca8afbef3de29408453b2e3

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp310-cp310-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 1b53f4c0aab137a9fd1e14f261862e54807a4fcc05bc92631c336ad59c805c61
MD5 0eb29f2679e2613eb5b8ac3341bdd0de
BLAKE2b-256 95f76358b3fe8b1643d6a675d1a96600405fcefe66a32e36e9422f1558ba9e60

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp39-cp39-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 7560e8db1b0e23acf212e522991edd6c67c8df26cdbf53ebbb07f5d815077ed2
MD5 b9ed415f8f446877a9703b3fe00a5c91
BLAKE2b-256 0ecb5fb2cfe2ff00176358cae0cef7ecda5cea2d302a15f17c180a982044a095

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 24f3f22cc2b0ca5d095e3399785c8f948845d06af02722aa4eb8a0175ea23b7c
MD5 2c4bd0e492b3573615ba337573d7bad8
BLAKE2b-256 6c7ded39fec9580af3e40f3c09532dbb9a0ca502b94a06ac3464f112c3b8ea31

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for avica-0.3.1.9-cp39-cp39-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7036d58037a148e6d7a236103eb89ec3ff8c31a1ab02cc60f50737accc4c30ff
MD5 ec31ef71ff6c0388eba104c64d333fce
BLAKE2b-256 861d75f3c4bc65b6b2b81e3358f4d6fc39663105fd02d169474c38b81972cf8d

See more details on using hashes here.

Provenance

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

This release

0.3.1.9 This release

16 files

0.3.1.8

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