Recent changes to Installation

Installation modified by André Offringa

André Offringa — Fri, 28 Feb 2020 10:36:50 -0000

--- v30
+++ v31
@@ -88,3 +88,11 @@
 CMake searches for the file `StationResponse/ITRFConverter.h` and the library `libstationresponse.a` or `libstationresponse.so`.

 Extra paths can be added to e.g. also include IDG. Paths can be separated with a ; (semicolon).
+
+### Using the MWA beam
+The MWA beam requires that a `.h5` file with beam coefficients is present in your path, which you can find in the MWA software tools. This file needs to be in your Python search path. WSClean will iterate over your Python search paths by executing the following Python program:
+
+    ::::python
+    import sys
+      for a in sys.path
+      print a

Installation modified by André Offringa

André Offringa — Mon, 24 Jun 2019 20:52:43 -0000

--- v29
+++ v30
@@ -45,7 +45,7 @@
 The LOFAR beam and IDG libraries are optional, but need to be installed manually from source if they are required (see elsewhere on this page).

 ### On Red Hat
-The following document lists some instructions that can be helpful for instaling WSClean on Red Hat: [Installing WSClean on rhel 7.6](Installation instructions RHEL 7.6) (Thanks to Leonardo Saavedra).
+The following document lists some instructions that can be helpful for instaling WSClean on Red Hat: [Installing WSClean on rhel 7.6](Installation instructions RHEL 7.6) (Thanks to Leonardo Saavedra from NRAO).

 ### Linking errors

Installation modified by André Offringa

André Offringa — Tue, 11 Jun 2019 06:25:37 -0000

--- v28
+++ v29
@@ -41,6 +41,8 @@
     apt-get install casacore-dev libgsl-dev libhdf5-dev libfftw3-dev libboost-dev \
     libboost-date-time-dev libboost-filesystem-dev libboost-program-options-dev \
     libboost-system-dev libboost-thread-dev libcfitsio-dev cmake g++
+
+The LOFAR beam and IDG libraries are optional, but need to be installed manually from source if they are required (see elsewhere on this page).

 ### On Red Hat
 The following document lists some instructions that can be helpful for instaling WSClean on Red Hat: [Installing WSClean on rhel 7.6](Installation instructions RHEL 7.6) (Thanks to Leonardo Saavedra).

Installation modified by André Offringa

André Offringa — Tue, 11 Jun 2019 06:23:42 -0000

--- v27
+++ v28
@@ -36,6 +36,11 @@
 If you want to make full-sky images or use the recentering technique, you will probably want to use the [chgcentre](chgcentre) tool too. This tool changes can change the phase centre of a measurement set, and is available in a separate package available on this website.

 ### On Ubuntu and Debian
+Binary packages are available on Ubuntu and Debian, and can be installed with `sudo apt-get install wsclean`. In case that version is new enough for your purpose, you're all done. If you want to compile WSClean from source, the following packages need to be installed:
+
+    apt-get install casacore-dev libgsl-dev libhdf5-dev libfftw3-dev libboost-dev \
+    libboost-date-time-dev libboost-filesystem-dev libboost-program-options-dev \
+    libboost-system-dev libboost-thread-dev libcfitsio-dev cmake g++

 ### On Red Hat
 The following document lists some instructions that can be helpful for instaling WSClean on Red Hat: [Installing WSClean on rhel 7.6](Installation instructions RHEL 7.6) (Thanks to Leonardo Saavedra).

Installation modified by André Offringa

André Offringa — Tue, 11 Jun 2019 06:06:29 -0000

--- v26
+++ v27
@@ -34,6 +34,11 @@
     cmake ../ -DCMAKE_PREFIX_PATH="/path/to/casacore;/path/to/cfitsio"

 If you want to make full-sky images or use the recentering technique, you will probably want to use the [chgcentre](chgcentre) tool too. This tool changes can change the phase centre of a measurement set, and is available in a separate package available on this website.
+
+### On Ubuntu and Debian
+
+### On Red Hat
+The following document lists some instructions that can be helpful for instaling WSClean on Red Hat: [Installing WSClean on rhel 7.6](Installation instructions RHEL 7.6) (Thanks to Leonardo Saavedra).

 ### Linking errors

Installation modified by André Offringa

André Offringa — Sun, 07 Apr 2019 10:17:08 -0000

--- v25
+++ v26
@@ -3,7 +3,7 @@
 Once you have the downloaded the package, you will need to compile WSClean. WSClean requires:

 * [Casacore](https://github.com/casacore/casacore), for opening measurement sets. Version >=2.0 is required, not lower. Casacore is required even if you already have Casa installed. Casacore needs to be compiled with C++11 support.
-* [FFTW](http://www.fftw.org/), used to perform Fourier transformations.
+* [FFTW](http://www.fftw.org/) version 3.3.5 or newer, used to perform Fourier transformations.
 * [Boost](http://www.boost.org/), used for threading, date and time calculations and some other general functionalities.
 * [CFITSIO](http://heasarc.nasa.gov/fitsio/), for reading and writing FITS files.
 * [GSL](https://www.gnu.org/software/gsl/), the GNU Scientific Library, used for certain computations.

Installation modified by André Offringa

André Offringa — Fri, 01 Mar 2019 11:22:17 -0000

--- v24
+++ v25
@@ -59,18 +59,20 @@

 ### Using the LOFAR beam

-To have the LOFAR beam available in WSClean, CMake needs to find the LOFAR installation on your computer. If you have installed LOFAR in a custom directory, you can add it to your search path. For example, if the LOFAR tree has been installed to `~/Software/LOFAR-install`, this cmake command will use it:
+NB: WSClean used to use the LOFAR beam from the LOFAR repository, but versions after 2.6 require the "LOFARBeam" package from Github instead. The LOFARBeam package can be find here: https://github.com/lofar-astron/LOFARBeam
+
+To have the LOFAR beam available in WSClean, CMake needs to find the LOFARBeam installation on your computer. If you have installed LOFARBeam in a custom directory, you can add it to your search path. For example, if LOFARBeam been installed to `~/Software/LOFARBeam-install`, this cmake command will use it:

     ::::bash
-    cmake ../ -DCMAKE_PREFIX_PATH="~/Software/LOFAR-install/"
+    cmake ../ -DCMAKE_PREFIX_PATH="~/Software/LOFARBeam-install/"

 CMake will tell whether the LOFAR tree was found:

     ::::bash
-    cmake ../ -DCMAKE_PREFIX_PATH="~/Software/LOFAR-install/"
+    cmake ../ -DCMAKE_PREFIX_PATH="~/Software/LOFARBeam-install/"
     [..]
     LOFAR beam library found.

-CMake searches for the file `StationResponse/Station.h` and the library `libstationresponse.a` or `libstationresponse.so`.
+CMake searches for the file `StationResponse/ITRFConverter.h` and the library `libstationresponse.a` or `libstationresponse.so`.

 Extra paths can be added to e.g. also include IDG. Paths can be separated with a ; (semicolon).

Installation modified by André Offringa

André Offringa — Fri, 11 Jan 2019 12:41:54 -0000

--- v23
+++ v24
@@ -19,6 +19,10 @@
     cd build
     cmake ../
     make -j 4
+
+And optionally:
+
+    sudo make install

 If cmake reports errors, you might have to install or specify your libraries in the call to cmake if they are not in standard directories, e.g.:

Installation modified by André Offringa

André Offringa — Fri, 01 Dec 2017 12:50:08 -0000

--- v22
+++ v23
@@ -9,6 +9,8 @@
 * [GSL](https://www.gnu.org/software/gsl/), the GNU Scientific Library, used for certain computations.

 WSClean uses C++11 features. Because of this, building WSClean with GCC requires at least GCC version 4.8.1.
+
+To use the image domain gridder (a fast GPU gridder), you will need to install the IDG libraries from https://gitlab.com/astron-idg/idg . 

 After you have installed these libraries, you can compile WSClean with the following commands:

@@ -66,3 +68,5 @@
     LOFAR beam library found.

 CMake searches for the file `StationResponse/Station.h` and the library `libstationresponse.a` or `libstationresponse.so`.
+
+Extra paths can be added to e.g. also include IDG. Paths can be separated with a ; (semicolon).

Installation modified by André Offringa

André Offringa — Tue, 11 Jul 2017 11:57:33 -0000

--- v21
+++ v22
@@ -7,6 +7,8 @@
 * [Boost](http://www.boost.org/), used for threading, date and time calculations and some other general functionalities.
 * [CFITSIO](http://heasarc.nasa.gov/fitsio/), for reading and writing FITS files.
 * [GSL](https://www.gnu.org/software/gsl/), the GNU Scientific Library, used for certain computations.
+
+WSClean uses C++11 features. Because of this, building WSClean with GCC requires at least GCC version 4.8.1.

 After you have installed these libraries, you can compile WSClean with the following commands: