HDFLook scripts for creating GeoTIFF images from IMAPP MODIS Products
=====================================================================

Liam.Gumley@ssec.wisc.edu
14 April 2011

The scripts in this directory use the HDFLook application available from

ftp://loa630.univ-lille1.fr/HDFLOOK

to create GeoTIFF images from MODIS Level 1B and IMAPP MODIS Level 2 products.
These scripts were tested with HDFLook 9.6b for 32-bit Linux.

Instructions
============

1. Download and install HDFLook for your platform from

ftp://loa630.univ-lille1.fr/HDFLOOK/

To install HDFLook:

cd $HOME
mkdir HDFLook
cd HDFLook
wget ftp://loa630.univ-lille1.fr/HDFLOOK/LINUX_INTEL32_HDFLook.tar.gz
wget ftp://loa630.univ-lille1.fr/HDFLOOK/MAPS.tar.gz
tar zxf LINUX_INTEL32_HDFLook.tar.gz
tar zxf MAPS.tar.gz

- To configure HDFLook:

export HDFLOOKTMP=.
export HDFLOOKMAPS=$HOME/HDFLook/MAPS
export PATH=$HOME/HDFLook/LINUX_INTEL32

2. Download all files from the following FTP directory

ftp://ftp.ssec.wisc.edu/pub/gumley/hdflook_imapp/

3. Uncompress the files as follows
(a new directory named hdflook_imapp will be created)

$ tar zxf hdflook_imapp_scripts.tar.gz
$ tar zxf hdflook_imapp_data.tar.gz

4. Run the test script as follows

$ cd hdflook_imapp
$ ./Script.bash

This script will create GeoTIFF images for the following products:

Band 2, Band 31, True Color, Cloud Mask, Cloud Top Pressure,
Total Precipitable Water, Aerosol Optical Thickness, Total Ozone.

Notes
=====

a. See the template*.txt files for the HDFLook scripting syntax needed
to create each image.

b. To get help with the HDFLook scripting syntax, type

$ HDFLook -help

c. The default projection for the images is LINEAR (also known as equirectangular,
equidirectional, equidistant cylindrical, geographic, or plate carrée projection).
This projection is notable because it is the projection used by Google Earth.
However, this projection will not work well near the poles.

d. Projections available for GeoTIFF images in HDFLook include

 Projection                   HDFLook name   Geotiff name
 Linear                       LINEAR         CT_Equirectangular
 Azimuthal Equidistant        AZIMUTHAL      CT_AzimuthalEquidistant
 Lambert Azimuthal equal area LAMBERT        CT_LambertAzimEqualArea
 Miller Cylindrical           MILLER         CT_MillerCylindrical
 Orthographic                 ORTHOGRAPHIC   CT_Orthographic
 Robinson                     ROBINSON       CT_Robinson
 Sinusoidal                   SINUSOIDAL     CT_Sinusoidal
 Van Der Grinten              VANDERGRINTEN  CT_VanDerGrinten

e. The default resolution for the images is 4000 meters per pixel. You can edit
the template file and change this value to whatever you like.

f. By default, HDFLook will adjust the lat/lon region to match each granule. However if
you need to define a specific lat/lon region for the projected image, edit the
template file to use the following syntax:

set_projection_to_geometry ProjectionTo=Orthographic PixelSizeXTo=4000 PixelSizeYTo=4000 \ 
 LatitudeMaxTo=-25.0 LatitudeMinTo=-35.0 \
 LongitudeMinTo=14.0 LongitudeMaxTo=30.0