Installation

Installation and setup for the Next Generation CASA Prototype

Pip Installation

python3 -m venv ngcasa
source ngcasa/bin/activate
pip install ngcasa

Conda Installation

conda create -n ngcasa python=3.6
conda activate ngcasa
pip install ngcasa

Installation from Source

git clone https://github.com/casangi/ngcasa.git
cd ngcasa
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py install --root=.

Configure dask.distributed

To avoid thread collisions, when using the Dask.distributed Client, set the following environment variables.

export OMP_NUM_THREADS=1 
export MKL_NUM_THREADS=1
export OPENBLAS_NUM_THREADS=1 

Building Documentation from Source

Follow steps to install cngi from source. Then navigate to the docs folder and execute the following:

sphinx-build -b html . ./build

View the documentation in your browser by navigating to:

file:///path/to/ngcasa/ngcasa/docs/build/index.html

Usage

>>> from ngcasa.synthesis.imaging import make_imaging_weights
>>> xds = make_imaging_weights(...)

Throughout the documentation we use the variable name xds to refer to Xarray DataSets.
xda may be used to refer to Xarray DataArrays. This is a "loose" convention only.