Rapthor is an experimental pipeline for correcting direction-dependent effects in LOFAR data. It uses DP3 and WSClean to derive and apply the corrections in facets or as smooth 2-D screens. It uses CWL for the pipeline language and Toil to run the pipelines.

Extensive documentation can be found on Read the Docs.

To install rapthor, follow the instructions below.

Rapthor requires the following packages (beyond those installed automatically with rapthor):

• WSClean (version 2.9 or later; building with IDG and EveryBeam is required)
• DP3 (version v4.1 or later; building with Dysco and EveryBeam is required)
• LSMTool (version 1.4.2 or later)
• LoSoTo (version 2.0 or later)
• PyBDSF (version 1.9.2 or later)

Installation can be done in a number of ways. In order of preference (read: ease of use):

1. Install the latest release from PyPI:

   pip install rapthor
   

2. Install directly from the Rapthor git repository. This option is useful if you want to use one or more features that have not yet been released:

   pip install --upgrade pip
   pip install git+https://git.astron.nl/RD/rapthor.git[@<branch|tag|hash>]
   

   If the optional @<branch|tag|hash> is omitted, HEAD of the master branch will used.

3. Clone the git repository, and install from your working copy. This option is mostly used by developers who want to make local changes:

   pip install --upgrade pip
   git clone https://git.astron.nl/RD/rapthor.git
   cd rapthor
   git checkout [<branch|tag|hash>]  #optionally
   pip install .