ccplot

CloudSat and CALIPSO plotting tool

Download

Source distribution

Pick a ccplot source distribution from the table below. Also see the version history. ccplot is provided under the terms of 2-clause BSD license, allowing you to redistribute and modify the software, and use it in commercial products without restrictions.

Release DateDownload
16 June 2013 ccplot 1.4.7
12 June 2013 ccplot 1.5-rc4 (beta)
Archive

Requirements

We recommend installing on Linux. Make sure you have the following programs and libraries installed:

Debian/Ubuntu

On Debian and Ubuntu, install dependencies with:

# ccplot < 1.5
apt-get install python python-dev python-numpy python-matplotlib python-mpltoolkits.basemap

# ccplot >= 1.5
apt-get install --no-install-recommends cython libhdf4-dev libhdfeos-dev python-imaging python-numpy python-matplotlib python-mpltoolkits.basemap ttf-bitstream-vera

ccplot < 1.5: PyNIO needs to be installed independently.

Installing PyNIO

ccplot < 1.5

PyNIO can be downloaded upon free registration on ESG. However, to make your life easier, you can also download PyNIO precompiled binaries without registration from our website (recommended). If you need to build PyNIO from source, follow the instructions on the PyNIO website.

To install PyNIO from a binary distribution, on Ubuntu and Debian with Python:

# Substitute the right name of the binary archive and Python version.

mkdir pynio
tar -C pynio -xzf PyNIO-1.4.0.linux-debian-x86_64-gcc432-py265-numpy141-nodap.tar.gz
sudo cp -r pynio/lib/python2.6/site-packages/* /usr/local/lib/python2.6/dist-packages/

on other systems:

# Substitute the right name of the binary archive.

tar -C /usr/local -xzf PyNIO-1.4.0.linux-debian-x86_64-gcc432-py265-numpy141-nodap.tar.gz

Test installation (optional):

python -c "import Nio; print Nio.__version__"
1.4.0

Installing ccplot

Unpack the source archive, build and install with:

tar xzf ccplot-1.4.6.tar.gz
cd ccplot-1.4.6
python setup.py build
sudo python setup.py install

Your Experience

If you have any difficulty with the installation, or if you find a bug, please write to the mailing list at ccplot-general@lists.sourceforge.net, or submit an issue on GitHub.

Tutorial

Please continue with ccplot manual (Chapter 6) in Visualising Data from CloudSat and CALIPSO Satellites and ccplot man page.

Known issues

4 June 2013

There is a bug with python-dap which causes a warning to be printed:

/usr/lib/pymodules/python2.7/mpl_toolkits/__init__.py:2: UserWarning: Module dap was already imported from None, but /usr/lib/python2.7/dist-packages is being added to sys.path __import__('pkg_resources').declare_namespace(__name__)

Package python-dap is installed on Ubuntu and Debian as "recommended" by python-mpltoolkits.basemap. It can be removed (as it is not required), and the warning will not appear any more.

The bug has already been reported to the Debian bug reporting system.

12 June 2013

ccplot < 1.5: There is a bug in NetCDF compatibility layer of libhdf4 (used by PyNIO) which causes wrong size of datasets to be reported. As a result, the data may be trimmed by a relatively small amount of rays at the end of a granule. The bug has been confirmed by the HDF Group, and is being solved.

16 June 2013

ccplot <= 1.4.6 There was a serious bug in the visualization of CALIPSO profiles, when the altitude of data points was shifted by one element, resulting in a difference of as much as 300m relative to their true location. The difference in the highest-resolution regions was 60m.