almaqso 1.0.2

ALMA QSO analysis

almaqso

This repository is a folk of astroysmr/almaqso, which is no longer maintained. So many bugs are still there, and I am trying to fix them.

PLEASE REFER TO THE ISSUE SECTION SINCE IT CONTAINS THE BUGS AND INFORMATION.

Pre-requisites

CASA

• Please use CASA with ALMA pipeline. I am using CASA version 6.6.1-17-pipeline-2024.1.0.8.

CASA Modules

• analysisUtilities
• UVMultiFit: (optional) When you run analysis with mode='aftercal' or mode='all' (this means that you run Step 5), this is needed. If you use CASA 6, you should switch the branch to develop to build properly.

Details (e.g., how to install and modify) are described in Pre-requisites.

Installation

You can install this package by

pip install git+https://github.com/skrbcr/almaqso.git

Then you can use the package like this:

import almaqso

Usage

See sample folder and documentation.

Test

CASA to use

First, make sure that you have CASA with alma pipeline installed e.g., the version that I am using. To set environment variables shown below, you can tell this program which CASA to use:

bash and zsh

Write above line in your .bashrc or .zshrc.

export ALMAQSO_CASA=/path/to/your/casa

fish

Write above line in your config.fish.

set -gx ALMAQSO_CASA /path/to/your/casa

Note

I am considering to delete this feature and alternatively I want you to specify the path to CASA in the parameter of the functions.

Prepare the environment

Then please install pipenv.

pip install pipenv

Then, you can reproduce the environment by

pipenv install --dev

You can enter the environment by

pipenv shell

Test run

Edit test/test_download_analysis.py:

# test/test_download_analysis.py
# Edit the following constants.
DOWNLOAD = False  # True: Download the tar file, False: Use the existing tar file
MODE = 'aftercal'  # 'all': All Steps, 'calonly': Step 1-4, 'aftercal': Step 5-8 of analysis

Then you can run the test by

pytest

Usage

To work with this package, you have to download JSON files from ALMA Calibrator Source Catalogue. Explanation on it is here.

Sample code is at sample/sample.py.