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.

System Requirements

Software requirements. ccplot can potentially run on any unix-like operating system or even on Windows; however, at this stage it has only been tested on Linux. Especially, the binaries of PyNIO (a library ccplot depends on) are only available for Linux, Mac OS and Solaris, and it is rather challenging to build it from source. Therefore, we strongly recommend that you install ccplot on Linux for the first time.

A modern Linux distribution with a packaging system will be of great help because of the large number of dependencies. Unfortunately, some of the dependencies are not available in most distrubutions, and you will need to build them from source.

Hardware requirements. For a pleasant experience you should have a decent CPU, 2GHz or more, depending on architecture. If you want to plot full MODIS granules, you will need about 2GB of RAM. Otherwise, 1GB RAM is a bare minumum.

Installing Dependencies

For the time being ccplot has only been tested on unix-like operating systems. You will need a few other programs and libraries to install and run ccplot:

    # apt-get install gcc g++ libpng12-0 libpng12-dev libfreetype6 libfreetype6-dev libcairo2
                      libcairo2-dev python python-dev python-numpy python-cairo python-matplotlib

1. gcc and g++, the C and C++ compilers. The GNU Compiler Collection should generally be available on any modern unix-like operating system. Try the packaging system if your OS has one, or the OS installation media.
2. libpng 1.1 or newer, freetype 1.4 or newer, and cairo. It is very likely that you have these installed, or that they are in your packaging system.
3. Python 2.5 or 2.6 and development files. If you use a modern OS with a packaging system, you will almost certainly find it there. You will have to install Python development files as well. On Debian and Ubuntu, the package is called python-dev.
4. numpy 1.1 or newer. Again, if your OS has a packaging system, it is likely that numpy is there.
5. matplotlib 0.98.1 or newer. Not so common in package repositories, although Debian and Ubuntu have a sufficiently recent version.
6. basemap 0.99.4 or newer and the GEOS library (shipped with basemap). Basemap is rare in packaging systems. After you have downloaded the source distribution, unpack, build and install using the following commands:

       $ tar xzf basemap-1.0.1.tar.gz
       $ cd basemap-1.0.1.tar.gz
       $ cd geos-2.2.3
       $ export GEOS_DIR=/usr/local        (on C shell: setenv GEOS_DIR /usr/local)
       $ ./configure --prefix=$GEOS_DIR
       $ make
       # make install                      (as root)
       $ cd ..
       $ python setup.py build
       # python setup.py install           (as root)
       
       Test installation (optional):
       $ python -c "import mpl_toolkits.basemap as b; print b.__version__"
       1.0.1

   If that doesn't work for you, follow the instructions in README under the basemap-1.0.1 directory.
7. PyNIO 1.3.0b1 or newer. 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 or Debian with Python 2.6:
       $ mkdir pynio
       $ tar -C pynio -xzf PyNIO-1.4.0.linux-debian-x86_64-gcc432-py265-numpy141-nodap.tar.gz
       (substitute with the name of the binary you downloaded)
       # cp -r pynio/lib/python2.6/site-packages/* /usr/local/lib/python2.6/dist-packages/
       (as root)
       
       On other systems:
       # tar -C /usr/local -xzf PyNIO-1.4.0.linux-debian-x86_64-gcc432-py265-numpy141-nodap.tar.gz
       (as root; substitute with the name of the binary you downloaded)
       
       Test installation (optional):
       $ python -c "import Nio; print Nio.__version__"
       1.4.0

Installing ccplot

Installing ccplot from the source distribution is easy.

1. Unpack the archive:

       $ tar xzf ccplot-1.44.tar.gz

2. Go to the source code directory and build the source code:

       $ cd ccplot-1.44
       $ python setup.py build

3. Log in as root and install ccplot:

       # python setup.py install

   Alternatively, use sudo if your OS supports it:

       $ sudo python setup.py install

Your Experience

The installation procedure is difficult, and there are few ccplot users at the moment, because the project is just starting. That is why we will appreciate if you tell us about your experience with the installation, both positive and negative.

You can use the feedback form on the main page or write to the mailing list.