Home

This is the WSClean wiki main page. Below you can find several pages with information about WSClean. The latest version of WSClean is version 2.10, released 2020-07-16, and can be downloaded here:

**Version 2.10 release 2020-07-16 is the last version of WSClean released on SourceForge. Future development will move to GitLab: https://gitlab.com/aroffringa/wsclean **
Refer to the installation instructions for help. Changes in the newest version are summarized on its changelog (or see older changelogs).

If you use WSClean for scientific work, please cite the Offringa et al. (2014) (arxiv.org) <bibtex> WSClean paper. The multi-scale, multi-frequency and auto-masking algorithms are described in a second paper: Offringa & Smirnov (2017) <bibtex>. In case IDG is used, please also cite Van der Tol, Veenboer & Offringa (2018) <bibtex>.

Click on one of the following subjects for more information:

1. Getting started
   • Introduction
   • Usage
   • Basic cleaning
   • Prediction (or 'FT'-ing an image)
   • WSClean and selfcal
2. Weighting
   • Image weighting
   • Tapering of image weights
   • MF image weighting
   • Weight rank filter
3. Advanced imaging modes
   • Making image cubes
   • Snapshot imaging (making many images by splitting in time)
   • W-snapshot algorithm
   • Changing the phase centre with chgcentre
   • Baseline-dependent averaging
   • Continuing a previous deconvolution and reusing images
   • WGridder, a highly accurate and fast gridder
   • Distributed imaging using OpenMP
4. Image-based and gridding based primary beam correction
   • LOFAR/AARTFAAC primary beam correction
   • MWA primary beam correction
   • Using the image-domain gridder (IDG)
   • A-term correction
   • Joint imaging of multiple pointings
5. Advanced deconvolution modes
   • Using masks and auto-masking
   • Local RMS thresholding
   • Wideband deconvolution: using multi-frequency deconvolution
   • Polarized cleaning
   • RM-synthesis
   • Multi-scale cleaning
   • IUWT compressed sensing deconvolution
   • 'MORESANE' compressed sensing deconvolution
   • Parallel cleaning
6. Technical details
   • Clean component list output
   • Weighting and gridding
   • How the PSF beam-size is determined
   • How polarizations and their weights are formed
   • Fits keywords
   • Performance explanation
   • Using WSClean's gridder inside other software
   • Storing imaging weights
   • Gridder API documentation
7. Results
   • Imaging artefacts
   • Diverging clean

Other resources:

• Debian WSClean tracker: https://tracker.debian.org/pkg/wsclean
• WSClean Development

To contact me, mail me on offringa at gmail dot com.

Many people have greatly helped the development of WSClean by submitting bug reports, feature requests, ideas and patches, for which I am very grateful. Bas van der Tol and Bram Veenboer have in particular contributed a lot to WSClean.

Project Members:

• André Offringa (admin)
• All Members