README.md

LEAP Accelerate

leap-accelerate is a calibration tool implementing Low-frequency Excision of the Atmosphere in Parallel (LEAP) for low-frequency radio antenna arrays. Leap utilizes GPGPU acceleration for parallel computation across baselines, channels and polarizations and is freely available on GitLab under GPLv2+ License.

leap-accelerate includes:

• leap-accelerate: a shared library for gpu accelerated direction centering and phase calibration.
• leap-accelerate-cli: a CLI interface for I/O datastream or plasma data access.
• leap-accelerate-python: python3 bindings to leap-accelerate using pybind11.

See the online documentation for more information.

Installation

leap-accelerate and leap-accelerate-cli

Build

cmake -B build -G "Ninja Multi-Config"
cmake --build build --config Release -j8

Test

ctest --test-dir build -C Release -T test --verbose

Install

cmake --install build --config Release

OSI Image

The latest leap release is published as a debian a docker image available at the following location:

artefact.skao.int/icrar-leap-accelerate:latest

NOTE: It may be necessary to use the image tag rather than just 'latest'.

This image can be run locally using the following command:

docker run -it --rm artefact.skao.int/icrar-leap-accelerate:latest LeapAccelerateCLI --help

See the docker documentation for instructions about how to create a docker image.

See the build documentation for instructions on platform specific compilation.

Usage

See leap-accelerate-cli for instructions on command line arguments and configuration files.

Examples:

LeapAccelerateCLI --help

LeapAccelerateCLI --config "./askap.json"

Contributions

Refer to the following style guides for making repository contributions

• CMake Style Guide
• C++ Style Guide