VAST Post-Processing

This repository contains the code of VAST Post-Processing, which further processes ASKAP-VAST observation data.

Features

• Code base in Python 3.9.x
• Crops and corrects FITS images
• Crops and corrects catalogues
• Generates MOCs and STMOCs

Installation

1. Clone this repository onto your local machine.

git clone [email protected]:askap-vast/vast-post-processing.git

2. Navigate to the repository.

cd vast-post-processing/

3. Install Poetry and Poe the Poet.

pip install poetry
pip install poethepoet

4. Install the rest of this package's dependencies with Poetry.

poetry install

5. The package is now installed. You can enter a virtual environment with

poetry shell

Usage

This project is separated by module. The following modules are available by command.

• link_neighbours
• convolve_neighbours
• swarp_neighbours
• selavy_prepare
• crop_fields

To run the main program, run

vast_post_processing --data-root <DIRECTORY>

Testing

The test suite expects at least one image observation, and its corresponding data files. To check for the existence and organisation of the test data, run the data test subsuite.

1. Follow the installation instructions above, and if not already entered, enter the vast-post-processing environment with

poetry shell

2. Test for local test data existence with

pytest tests/data/test_data.py

3. If all tests pass, proceed to develop your own tests. Otherwise, your test data directory is not initialised or configured correctly. Run the pull_data script with

pull_test_data

This process will take several minutes.

Note this script requires ssh access to the vast-data virtual system. Read here for more information.

You can edit various settings and which observations to pull in tests/data/pull_config.yaml.

4. After test data has been downloaded, the fixtures found in the various conftest.py files will resolve, and all current tests should pass. Future tests can now be implemented as well.

Contributors

Contributor	Organisation	Department
Dougal Dobie	Swinburne University of Technology	Centre for Astrophysics and Supercomputing
Andrew O'Brien	University of Wisconsin-Milwaukee	Center for Gravitation, Cosmology & Astrophysics
Akash Anumarlapudi	University of Wisconsin-Milwaukee	Center for Gravitation, Cosmology & Astrophysics
Mubdi Rahman	Sidrat Research
Hansen Jiang	Sidrat Research