Download

CPL Title Graphic

Current CPL Release

The following table provides the download links for the latest offical release of the CPL source packages, the documentation, and the Esorex tool. As a convenience the source packages of the third-party libraries which were used to verify this CPL release are also available from the table below.

Previous CPL releases are available here.

Filename Description MD5
cpl-6.4.2.tar.gz CPL source code distribution
Note: should be used with CFITSIO 3.350 or later
661cdf67f6814f622fe36d282fd1186a
cpl-user-manual_6.0.pdf CPL User Manual (still needs to be updated)
cpl-ref-manual-6.4.1.pdf CPL Reference Manual (PDF)
The on-line version of the manual is available here.
esorex-3.10.2.tar.gz ESO Recipe Execution tool
Note: for CPL 6.4 or later use esorex 3.10 or newer.
e28f3a94b1e208bff33bc7d4840d6f41
cfitsio3350.tar.gz CFITSIO library from NASA, version 3.350 b8c6307c21e178174b61000af5406757
wcslib-4.16.tar.bz2 WCSLIB library of M. Calabretta, version 4.16 30439a0bb730ef936646d646c9f07518
fftw-3.3.3.tar.gz FFTW library, version 3.3.3 0a05ca9c7b3bfddc8278e7c40791a1c2

Note: The integrity of the downloaded packages may be verified using the MD5 signatures from the table (see here for details).

Previous CPL Releases

The last releases of the CPL source packages can be accessed through the links in the table. In addition the third-party library packages which were used and tested with the individual releases are also available.


System requirements

The CPL is supported on the VLT target platforms running the following operating systems:

  • Scientific Linux 5.3 (32bit/64bit)
  • Scientific Linux 5.5 (32bit/64bit)
  • Scientific Linux 6.3 (64bit)
At this stage, only these operating system versions are officially supported!

However, it is intended that the CPL builds also on other flavors of Linux and Unix systems, and it is known that the CPL has been successfully built on recent Linux distributions (Fedora, OpenSUSE, Ubuntu, and others), as well as on Mac OS X platforms.

The following tools are needed to build the CPL from the source distribution:

  • GNU C/C++ compiler (version 4.4 or newer)
  • GNU make utility
  • GNU tar and gzip utilities.
  • Java Development Kit version 1.6 or newer (optional, only needed if Gasgano support is required)

Third-party libraries used in CPL

In addition to the development tools for building the CPL, it depends on a small number of external library packages:

  • CFITSIO
  • FFTW
  • WCSLIB
The recommended versions of these packages are also available from here.

Since CPL uses CFITSIO to access FITS files, it requires an appropriate CFITSIO installation to be available on the target system.
CPL also delegates some specific functionality, namely Fourier transforms and world coordinate system transformations to dedicated, specialized libraries. In case this functionality is not needed, CPL can be build and used without having FFTW and/or WCSLIB installed. However, in general this is not recommended, since Fourier transforms an world coordinate system handling are then not available in CPL!

Workarounds for Mac OS X users:

The following list provides hints to work around some known issues on Mac OS X:

  • Compilation error on Mac OS X 10.8 (or newer): version 6.1.1 of CPL cannot be built with the default C compiler (clang), because of unsupported C99 features. The current CPL release requires a full GCC installation which may be obtained from MacPorts for instance.
    This issue is fixed in CPL version 6.2!
  • Compilation error because of not finding the javah executable: to avoid this the environment variable JAVA_HOME which points to the JDK installation should be set to:
    JAVA_HOME=JAVA_HOME=/System/Library/Frameworks/JavaVM.framework before the configure script is executed. If this does not succeed try the following setting: JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home

Please note that support for Mac OS X can only be provided on a best effort basis!

Installing and using the CPL

Please refer to the README file in the CPL distribution for details about how to install and use the software. A detailed description of the library is provided in the CPL User Manual (see the link in the list of "downloads" above). Additional documentation is available from the CPL Documentation page.

Checking the Package Integrity

The integrity of the downloaded packages may be verified using the MD5 files which are available from the current release download table. They contain the MD5 fingerprint of the corresponding package. To verify the package, get the MD5 file by saving the MD5 sum link, put it into the same directory as the package, and execute the command: md5sum -c <md5file>