Skip to content
Suite of C++ libraries for radio astronomy data processing
C++ Fortran C CMake Shell Yacc Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.travis
build-tools Remove update measures (#854) May 21, 2019
casa
changescripts
cmake Switch to using the exported package configs for adios2. Feb 14, 2019
coordinates Catch all polymorphic exceptions by reference Mar 11, 2019
derivedmscal Merge pull request #918 from casacore/RemoveROMS Aug 8, 2019
fits Issue #118: replace Map, List, etc. by STL counterparts Mar 28, 2019
images CAS-12627 backward compatibility for matrices with one length being zero Sep 16, 2019
lattices Added test coverage for the Fit2D::estimate method Jul 24, 2019
meas
measures
mirlib
ms Merge pull request #918 from casacore/RemoveROMS Aug 8, 2019
msfits Merge pull request #918 from casacore/RemoveROMS Aug 8, 2019
python
python3 Use newest cmake features only in cmake 3.14 Jul 11, 2019
scimath bug fix where params in method call were transposed Nov 23, 2019
scimath_f add support for builds with Intel compilers and generic flags Feb 27, 2017
tables More fundamental fix for issue 970 Nov 5, 2019
.dockerignore
.gitignore User docker for Linux build on Travis for CI (#856) May 17, 2019
.travis.yml
CHANGES.md
CMakeLists.txt
CONTRIBUTING.md Update contributing guidelines May 29, 2018
COPYING Replace GPLv2.0 by LGPLv2.0 in COPYING Dec 8, 2018
README.md Add docker image link Jun 5, 2019
casacore try to fix #79 Apr 9, 2015
doxygen.cfg
mainpage.dox Improved thread-safety fixes of AvAmesfoort Sep 4, 2018

README.md

Casacore

A suite of C++ libraries for radio astronomy data processing.

Installation

Debian / Ubuntu

Casacore is now part of Debian and Ubuntu, use apt to search for the package you need:

$ apt-get update
$ apt-get search casacore

MacOS

Use Homebrew with the ska-sa tap to install casacore:

$ brew tap ska-sa/tap
$ brew install casacore

Docker

We now also publish docker images for each github branch on quay.io:

$ docker pull quay.io/casacore/casacore:master

Building from source

Getting the source code

The casacore source code is maintained on github.

You can obtain it using:

$ git clone https://github.com/casacore/casacore

Requirements

To compile casacore you need to meet the following requirements:

  • cmake
  • gfortran
  • g++
  • flex
  • bison
  • blas
  • lapack
  • cfitsio (3.181 or later)
  • wcslib (4.20 or later)
  • sofa (optional, only for testing casacore measures)
  • fftw3 (optional)
  • hdf5 (optional)
  • numpy (optional)
  • boost-python (optional)
  • ncurses (optional)

On Debian / Ubuntu you can install these with:

$ sudo apt-get install build-essential cmake gfortran g++ libncurses5-dev \
   libreadline-dev flex bison libblas-dev liblapacke-dev libcfitsio-dev \
   wcslib-dev 

and the optional libraries:

$ sudo apt-get install libhdf5-serial-dev libfftw3-dev python-numpy \
    libboost-python-dev libpython3.4-dev libpython2.7-dev

On CentOS7 you can install these with:

$ sudo yum install cmake cmake-gui gcc-gfortran gcc-c++ flex bison \
       blas blas-devel  lapack lapack-devel cfitsio cfitsio-devel \
       wcslib wcslib-devel ncurses ncurses-devel readline readline-devel\
       python-devel boost boost-devel fftw fftw-devel hdf5 hdf5-devel\
       numpy boost-python 

Obtaining measures data

Various parts of casacore require measures data, which requires regular updating. You can obtain the WSRT measures archive from the ASTRON FTP server:

ftp://ftp.astron.nl/outgoing/Measures/

Extract this somewhere on a permanent location on your filesystem.

Compilation

In the casacore source folder run:

mkdir build
cd build
cmake ..
make 
make install

there are various flags available to cmake to enable and disable options:

$ cmake -DUSE_FFTW3=ON -DDATA_DIR=/usr/share/casacore/data -DUSE_OPENMP=ON \
    -DUSE_HDF5=ON -DBUILD_PYTHON=ON -DUSE_THREADS=ON

The DATA_DIR should point to the location where you extracted the measures data. Special variables %CASAROOT% and %CASAHOME% can be used here, which can be set at run time through the .casarc file.

You can build python3 support using -DBUILD_PYTHON3=ON. Note that CMake may have problems detecting the correct python3 libraries and headers, so probably you need to set them manually. For example:

-DPYTHON3_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython3.4m.so
-DPYTHON3_INCLUDE_DIR=/usr/include/python3.4

To configure Python2 specific settings use:

PYTHON2_EXECUTABLE
PYTHON2_LIBRARY
PYTHON2_INCLUDE_DIR

To configure Python3 specific settings use:

PYTHON3_EXECUTABLE
PYTHON3_LIBRARY
PYTHON3_INCLUDE_DIR

If you run into problems with boost libraries, try setting -DBoost_NO_BOOST_CMAKE=True. This will be necessary if you have the libraries from NRAO casa in your PATH or LD_LIBRARY_PATH.

Documentation

http://casacore.github.io/casacore

Problems & bugs

If you have any issues compiling or using casacore, please open an issue on the issue tracker on github.

If you have patches please open a pull request. Your contributions are more than welcome! But to maintain a high code quality we have written a contribution manual, please read that first.

travis

Build Status

You can’t perform that action at this time.