Installation¶

Windows [1]¶

1. Download Python Anaconda 2.7
2. Open a terminal, navigate to the Anaconda installation directory and type conda install numpy , y
3. Grab the basemap package conda install basemap, y
4. install pillow conda install pillow, y
   • Ensure you have pillow, rather than PIL. Pillow is a newer and updated version of PIL
5. To install CCPLOT:
   • get ccplot-1.5-rc7.win32-py2.7.exe
   • run ccplot-1.5-rc7.win32-py2.7.exe
   • browse to the Anaconda install directory and install in \Anaconda\Lib\site-packages\
   • more information is at http://ccplot.org/
6. Optional:
   • If using Eclipse [2]:
     • within Eclipse, go to help –> Install New Software
       • input PyDev Website (http://pydev.org/updates)
     • under Windows –> Preferences –> PyDev –> Interpreters –> Python
       • “Advanced Auto Config” or manually find Anaconda
     • import the existing “CALIPSO_Visualizer” package under the file menu
   • If using PyCharm: Simply set the python interpreter to the one supplied by anaconda.
7. Download the zip from the GitHub or use Git (see cloning the repository <dev/startdev#Clone-the-Repository>)
8. Using command prompt or bash, cd into the VOCAL/calipso folder and use python Calipso.py
   • If using Eclipse or Pycharm, use their built-in tools to clone the repository from GitHub

Linux [3]¶

1. start off by grabbing the SciPy Stack
   • sudo apt-get install python-numpy python-scipy python-matplotlib
2. install basemap
   • sudo apt-get install python-mpltoolkits.basemap
3. installing CCPLOT
   • CCPLOT has quite a bit of dependencies, so run
     • sudo apt-get install --no-intall-recommends cython libhdf4-dev libhdfeos-dev python-imaging ttf-bitstream-vera
   • now CCPLOT needs to be built on Linux, so grab the source
   • extract the source anywhere you’d like, the directory does not matter
   • cd into the CCPLOT folder you just extracted
   • run python setup.py build
   • note if python cannot find HdfEosDef.h
     • run dpkg -L
     • search for the location of HdfEosDef.h, it is commonly found in usr/include/x86_64-linux-gnu/hdf/
     • open setup.py in the CCPLOT folder, and change line 24 to include your path
     • the new line would like similar to hdf_include_dirs = ['/usr/include/x86_64-linux-gnu/hdf', '/usr/include/hdf', '/usr/local/include/hdf/', '/opt/local/include']
     • rerun python setup.py build
   • run python setup.py install , sudo may be required as well
   • CCPLOT should be installed
4. install bokeh.color
   • sudo pip install bokeh
5. run the application with python CALIPSO_Visualization_Tool.py

OS X [4]¶

1. install XCode

   • if using OS 10.9, install xcode 6.2

2. install macport

   • if port command not found in terminal, edit paths by

     • sudo vi /etc/paths
     • add the following lines:
       • /opt/local/bin
       • /opt/local/sbin
     • restart terminal

   • do port selfupdate

     • if you receive the error *‘rsync: failed to connect to <address> : connection

       refused (61) ...’*

       • it is likely your firewall is preventing access to the address ref
       • navigate to /opt/local/etc/macports in your terminal
       • open sources.config with admin access sudo vim sources.conf
       • comment out the last line, replace it with https://distfiles.macports.org/ports.tar.gz [default] ref
       • run port -v -d sync
       • run port search hdf4
       • you should have queries show up, meaning ports it working!

3. run sudo port install hdf4 hdfeos py27-cython py27-numpy py27-matplotlib py27-matplotlib-basemap

4. as root, do the following commands

   • mv /usr/bin/python /usr/bin/python.orig
   • ln -s /opt/local/bin/python /usr/bin/python
   • run port select --set python python27

5. download ccplot-1.5.tar.gz from here

   • run tar xzf ccplot-1.5.tar.gz
   • cd ccplot-1.5.tar.gz
   • python setup.py build
   • python setup.py install --user
   • ccplot -v
   • and ccplot should be a recgonizable command!

6. Install bokeh port install py27-bokeh

7. Install sqlalchemy port install py27-sqlalchemy

8. download the IDE of your choice, or run python Calipso.py

Footnotes