Introduction

Note

For a quick introduction of how to install MIPS, refer to section Quick start instructions.

The Multi sensor Image Processing Software (MIPS) package produces RGB (Red Green Blue) images of MODIS and VIIRS granules into several format types. The format types are 1) subsets, 2) KMLs, 3) mosaic and 4) polar mosaic images. Prior to describing what each of these format types are, a brief overview will be given of the inner workings of MIPS.

Note that throughout the documentation, it is assumed that the following environmental variables have been set:

export MIPS_INSTALL_DIR=$HOME
export MIPS_HOME=$MIPS_INSTALL_DIR/mips.version.2.1.public

Set the above environmental variables to the appropriate location of where the MIPS directories have been installed.

How does MIPS process MODIS and VIIRS granules?

The processing of MODIS and VIIRS granules involves the following steps:
  1. Apply atmospheric correction using CREFL. This processing step improves the visual quality of the images.
  2. Project atmospheric corrected granules onto 10 by 10 degree tiles. Equal distant cylindric projection is used.
  3. If the granule is over a polar region, project onto 1024 by 1024 km tiles. Polar stereographic projection is used.
  4. If a tile of the same date and satellite sensor already exist, overlay the new tile onto the previous tile. This operation is coined as “compositing”. Compositing is necessary, since a tile can be half covered by an overpass. Thus the second overpass fills the second half.

In essence MIPS converts all the incoming granules into RGB tiles which will be processed at a later stage. The PNG file format is used for all the tiles.

Image format types

Subsets

A subset is an image which has specific geographical corner coordinates. Subset images are used to create images of specific regions on a regular basis, as incoming granules are processed.

Each subset image is defined in a configuration file (see section Subsets). When the subset image script is executed (see section Creating subsets), MIPS makes a list of all the composite tiles that have been created. For each subset image, all the tiles are identified which overlaps with the geographical bounding box of the subset. Using all the overlapping tiles, the tiles are “stitched” together so to create the subset image.

KMLs

The MODIS and VIIRS granule images can be viewed using Google Earth, and is accessed through KML files. Two types of KML files are produced by MIPS. The first type is an auto-update KML file. When this KML file is viewed in Google Earth, the most recent KML images are displayed and every ten minutes the most recent KML images are loaded. The second type of KML file is of a specific date, and through these KML files past KML files can be viewed.

For information about how to configure MIPS to produce KML files, refer to section KMLs. And refer to section Creating KMLs for more information about how to create KML files.

Mosaic

A subset image is intended to be of a relatively small geographical region. If it is desired to create a routine image of for example a continent such as Africa, the mosaic image format type has to be used. Like a subset image, a mosaic image is defined by it’s corner coordinates.

Refer to section Mosaic for more information about how to add a mosaic configuration. And for information about how to create mosaic images, refer to section Creating mosaic images.

Polar mosaic

Mosaic images can be created of the polar region. The upper or lower most latitude is used to define the geographical extent of a polar mosaic. For information about the configuration, refer to section Polar mosaic. And refer to section Creating polar mosaic images for information about how to create Polar mosaic images.

Compiling MIPS binaries

The programs distributed with MIPS have been successfully compiled on Redhat 6.4 and Ubuntu 12.4. Throughout this section it is assumed that the host system has a 64-bit Linux version and that the following directory exist:

$HOME/scratch

Executing compile script:

If the host operating system is Redhat 6.4, execute the following to compile the programs distributed with MIPS:

cd $HOME/scratch
/bin/bash $MIPS_HOME/scripts/utilities/compile_binaries_red_hat_6_4.bash \
    $MIPS_INSTALL_DIR/mips_compile_binaries \
    $PWD/ \
    $MIPS_HOME/bin &> $HOME/mips_bin_compile.log

ls $MIPS_HOME/bin

If the host operating system is Ubuntu 12.4, execute the following:

cd $HOME/scratch
/bin/bash $MIPS_HOME/scripts/utilities/compile_binaries_ubuntu_12_04.bash \
    $MIPS_INSTALL_DIR/mips_compile_binaries \
    $PWD/ \
    $MIPS_HOME/bin &> $HOME/mips_bin_compile.log

ls $MIPS_HOME/bin

Check if all the binaries had been compiled:

You should see the following binaries in the MIPS binary directory:

ls -1 $MIPS_HOME/bin
bc
crefl.1.7.1
cs2cs
fornav
geotifcp
h5dump
listgeo
ll2cr
ncdump
tbase.hdf

Configure MIPS for MODIS and VIIRS

Configure files $MIPS_HOME/scripts/environment/default/mips_modis_env.bash and $MIPS_HOME/scripts/environment/default/mips_viirs_env.bash.

For each file, the following variables have to be set:

MAGICK_TEMPORARY_PATH
Set the directory path where ImageMagick can store it’s temporary files.
MIPS_TILE_DIR:
The directory where the tiles image will be archived.
MIPS_POLR_TILE_DIR
The directory where the polar tiles image will be archived.
MIPS_KML_DIR
The directory where the KML files will be archived.
MIPS_SUBSET_DIR
The directory where the subset images will be archived.
MIPS_MOSAIC_DIR
The directory where the mosaic images will be archived.
MIPS_GRAN_IMG_DIR
The directory where the L1B/SDR granule images will be archived.
MIPS_KML_URL
The HTTP URL where the KML files can be accessed. This must point to the root directory of MIPS_KML_DIR.
LM_LICENSE_FILE
The IDL license file information.
MIPS_TEXCLUDE_CONF
A list of tile numbers that must not be processed.
MIPS_PTEXCLUDE_CONF
A list of polar tile numbers that must not be processed.

Subsets

Modify files $MIPS_HOME/config/modis_subsets.conf and $MIPS_HOME/config/viirs_subsets.conf. For both files, the format of each entry must be:

<Subset name>;<UL longitude> <UL latitude> <LR longitude> <LR latitude>;<HRES | MRES | LRES>
Definitions:
  1. UL = Upper Left, LR = Lower Right.
  2. For MODIS: HRES = 250m, MRES = 500m and LRES = 1km. For VIIRS: HRES = 375m and LRES = 750m.

Note

Do not forget the semi-colons!

Note

The tile coordinates should not be rounded values, eg. 50.0 or -170.0. Rather use values such as 51.0 and -169.

For each subset configuration, a directory called “Subset name” will be created in $MIPS_SUBSET_DIR. The subsets will be archived in these directories. Only subset images are more than half-way complete will be archived. Subset images that are incomplete are archived in $MIPS_SUBSET_DIR/intermediate.

Here is an example a subset configuration file:

USA1;-126.9674 50.4305 -111.7056 36.9407
USA2;-111.7056 50.4305 -96.4439  36.9407
USA3;-96.4439  50.4305 -81.1822  36.9407
USA4;-81.1822  50.4305 -65.9204  36.9407
USA5;-126.9674 36.9407 -111.7056 23.4509
USA6;-111.7056 36.9407 -96.4439  23.4509
USA7;-96.4439  36.9407 -81.1822  23.4509
USA8;-81.1822  36.9407 -65.9204  23.4509

True and false color images

The following files list the true and false color images that will be produced by MIPS:
  • $MIPS_HOME/config/modis_tile_bands.conf
  • $MIPS_HOME/config/viirs_tile_bands.conf
  • $MIPS_HOME/config/modis_polar_tile_bands.conf
  • $MIPS_HOME/config/viirs_polar_tile_bands.conf.

The CREFL band number combinations are used in these configuration files. Each entry must have the following format:

<Red band nr> <Green band nr> <Blue band nr> <Lower resolution sharpen band nr> <Higher resolution sharpen band nr>

An example for MODIS a true color band combination is:

1 4 3 1 1

Here the 0.62 nm, 0.54 nm and 0.46 nm bands are used for red, green and blue. And the 0.62 nm 500 m (lower resolution) and 250 m (higher resolution) band data are used for sharpening.

And an example for VIIRS a true color band combination is: 5 4 3 5 12 Here the 0.646 nm, 0.554 nm and 0.466 nm bands are used for red, green and blue. The 750 m resolution 0.646 nm band is used for band sharpening, and the 375 m resolution 0.645 nm band.

Here is a list of the VIIRS band numbers and the corresponding center wavelengths:

SDR name CREFL band # Center wavelength
I1 12 0.640 um
I2 7 0.865 um
I3 10 1.610 um
M2 2 0.445 um
M3 3 0.488 um
M4 4 0.555 um
M5 5 0.672 um
M7 7 0.865 um
M8 8 1.024 um
M10 10 1.610 um
M11 11 2.225 um

KMLs

The location where the KMLs files are archived is set by the config variable MIPS_KML_DIR, which is located in the environmental configuration file. The URL that points to this directory, is set by the config variable MIPS_KML_URL.

Mosaic

All mosaic image configurations must be set in the files $MIPS_HOME/config/modis_mosaic.conf and $MIPS_HOME/config/viirs_mosaic.conf. Similar to the subset configuration files, the configuration format for the mosaic images is:

<Mosaic image name>;<UL longitude> <UL latitude> <LR longitude> <LR latitude>;<HRES | MRES | LRES>
Definitions:
  1. UL = Upper Left, LR = Lower Right.
  2. For MODIS: HRES = 250m, MRES = 500m and LRES = 1km. For VIIRS: HRES = 375m and LRES = 750m.

Note

Do not forget the semi-colons!

Note

The tile coordinates should not be rounded values, eg. 50.0 or -170.0. Rather use values such as 51.0 and -169.

The resolution (in meters) of the mosaic images can be set by the config variable MIPS_GLOBAL_MOSAIC_RESOL. Note that this variable must be equal to a number which is divisible by 250m for MODIS and 375m for VIIRS.

Here is an example of a mosaic configuration file:

Africa;-18.7 37.6 56.3 -35.5;MRES
Africa;-18.7 37.6 56.3 -35.5;HRES
USA;-127.4 48.7 -65.4 21.9;MRES
USA;-127.4 48.7 -65.4 21.9;HRES

Polar mosaic

The config variable MIPS_NORTH_POLARM_LAT (MIPS_SOUTH_POLARM_LAT) set the lower (upper) bound of the polar mosaic image. The output resolution of the polar mosaic image can be set by the config variable MIPS_POLAR_MOSIAC_RESOL. Note that this variable must be equal to a number which is divisible by 250m for MODIS and 375m for VIIRS.

Executing MIPS processing scripts

First the MIPS config file has to be loaded in the shell (BASH) environment prior to processing VIIRS or MODIS granules. The config file must always be loaded whenever a MIPS script is executed. To load the config file for MODIS:

source $MIPS_HOME/scripts/environment/default/mips_modis_env.bash

And for VIIRS:

source $MIPS_HOME/scripts/environment/default/mips_viirs_env.bash

Creating tiles

Separate scripts have to be executed for VIIRS and MODIS granules.

Processing VIIRS SDR granules

For VIIRS, use either $MIPS_HOME/scripts/process_granule_tiles_viirs_wrap.bash or $MIPS_HOME/scripts/process_granule_tiles_viirs.bash. The first script is a wrapper which extracts the date and time form the SDR file names. With the second script, the date and time have to be explicitly specified.

Here is an example of how to process a VIIRS SDR granule with the wrapper script, assuming that all the files are in the current directory.:

$MIPS_HOME/scripts/process_granule_tiles_viirs_wrap.bash \
    SVI01_npp_d20130218_t0746090_e0747331_b00001_c20130218080456143012_cspp_dev.h5 \
    SVI02_npp_d20130218_t0746090_e0747331_b00001_c20130218080456149075_cspp_dev.h5 \
    SVM02_npp_d20130218_t0746090_e0747331_b00001_c20130218080456283211_cspp_dev.h5 \
    SVM03_npp_d20130218_t0746090_e0747331_b00001_c20130218080456288666_cspp_dev.h5 \
    SVM04_npp_d20130218_t0746090_e0747331_b00001_c20130218080456294063_cspp_dev.h5 \
    SVM05_npp_d20130218_t0746090_e0747331_b00001_c20130218080456299446_cspp_dev.h5 \
    SVM07_npp_d20130218_t0746090_e0747331_b00001_c20130218080456310279_cspp_dev.h5 \
    GMTCO_npp_d20130218_t0746090_e0747331_b00001_c20130218080455911526_cspp_dev.h5

Processing MODIS L1B granules

For MODIS, use either $MIPS_HOME/scripts/process_granule_tiles_modis_wrap.bash or $MIPS_HOME/scripts/process_granule_tiles_modis.bash. The first script is a wrapper which extracts the date and time form the L1B file names. With the second script, the date and time have to be explicitly specified. Note that the naming convention of the L1B files that is used for these scripts is as follows:

M<O,Y>D.A<Year><Julian day>.<UTC time>.005.NRT.hdf

Here is an example of how to process a MODIS L1B granule with the wrapper script, assuming that all the files are in the current directory.:

$MIPS_HOME/scripts/process_granule_tiles_modis_wrap.bash \
    MYD021KM.A2013051.1250.005.NRT.hdf \
    MYD02HKM.A2013051.1250.005.NRT.hdf \
    MYD02QKM.A2013051.1250.005.NRT.hdf \
    MYD03.A2013051.1250.005.NRT.hdf

Creating subsets

Mention path and false color combination.

$MIPS_HOME/scripts/process_subsets.bash

Creating KMLs

Mention path and false color combination.

$MIPS_HOME/scripts/process_kml.bash

Creating mosaic images

Mention path and false color combination.

$MIPS_HOME/scripts/process_mosaic.bash

Creating polar mosaic images

Mention path and false color combination.

$MIPS_HOME/scripts/process_polar_mosaic.bash

Testing MIPS

MIPS should be first tested, before it made part of the operational system. Test scripts are available which process several test granules. The following procedure should be followed to test MIPS:

  1. Execute test processing script and check for any errors. Section Processing the test granules will explain how to execute this script.
  2. Compare KML and subsets images with example images, so to make sure that the output images are correct. Section Check if the test images are correct will give details of where to find the example images.

Processing the test granules

First copy the test script to the test data directories, by executing the following command:

cp $MIPS_HOME/scripts/test_scripts/*.bash $MIPS_INSTALL_DIR/mips_test_data/

Create scratch directory where the temporary processing files can be stored. Also create a log directory for the test log files. Preferably the disk access and write speeds should be high. And 50 GB of disk space will be sufficient for the scratch directory.

Now suppose the scratch and log directories are under the home directory. Set the SCRATCH_DIR and LOG_DIR environment variables to the corresponding directories. For example:

export SCRATCH_DIR=$HOME/scratch
export LOG_DIR=$HOME/log

Test scripts are available for each sensor and satellite (MODIS-Terra, MODIS-Aqua, VIIRS-NPP). Execute the corresponding scripts as described below. For VIIRS NPP:

/bin/bash $MIPS_INSTALL_DIR/mips_test_data/test_viirs_suomi_npp.bash $SCRATCH_DIR $LOG_DIR

For MODIS TERRA:

/bin/bash $MIPS_INSTALL_DIR/mips_test_data/test_modis_terra.bash $SCRATCH_DIR $LOG_DIR

For MODIS AQUA:

/bin/bash $MIPS_INSTALL_DIR/mips_test_data/test_modis_aqua.bash $SCRATCH_DIR $LOG_DIR

Here is an example of the screen output of the test_viirs_suomi_npp.bash script when a test is successful:

(3.1 Processing test SDRs)
(3.2 Processing KML files)
(3.3 Processing subset files)
VIIRS NPP test passed!

Check if the test images are correct

To check whether MIPS images are indeed correct, the output images have to compared to example MIPS images. Example MIPS images are available at the following web addresses:

Download these files and untar the tar files under a temporary directory. For example:

mkdir $HOME/mips_test_products_compare
cd $HOME/mips_test_products_compare
wget ftp://ftp.ssec.wisc.edu/pub/willemm/mips.version.2.1.public/mips_test_products_compare/mips_modis_test_compare.tar
tar xf mips_modis_test_compare.tar
rm mips_modis_test_compare.tar
wget ftp://ftp.ssec.wisc.edu/pub/willemm/mips.version.2.1.public/mips_test_products_compare/mips_viirs_test_compare.tar
tar xf mips_viirs_test_compare.tar
rm mips_viirs_test_compare.tar

Then the directory mips_test_products_compare will contain the following files:

ls -1
modis
viirs

Compare KML files

To check whether the KML images have been successfully created, load the local KML files in Google Earth. The local true color VIIRS KML file which has been created by your MIPS installation, is located at the following path:

$MIPS_HOME/products/viirs/kml/20130218/05_04_03_05_12/20130218.05_04_03_05_12.npp.kml

The corresponding example local true color VIIRS KML file is located at:

$HOME/mips_test_products_compare/viirs/kml/20130218/05_04_03_05_12/20130218.05_04_03_05_12.npp.kml

The KML images of these files should look very similar.

Compare the following KML files with the corresponding example KML files:

$MIPS_HOME/products/modis/kml/20130218/01_04_03_01_01/20130218.01_04_03_01_01.terra.kml
$MIPS_HOME/products/modis/kml/20130218/07_02_01_02_02/20130218.07_02_01_02_02.terra.kml
$MIPS_HOME/products/modis/kml/20130218/01_04_03_01_01/20130218.01_04_03_01_01.aqua.kml
$MIPS_HOME/products/modis/kml/20130218/07_02_01_02_02/20130218.07_02_01_02_02.aqua.kml
$MIPS_HOME/products/viirs/kml/20130218/05_04_03_05_12/20130218.05_04_03_05_12.npp.kml
$MIPS_HOME/products/viirs/kml/20130218/11_07_05_07_07/20130218.11_07_05_07_07.npp.kml

Compare subset images

To check whether the subsets images have been successfully created, load the subsets images in an image viewer. A true color jpeg subset image which has been created by your MIPS installation, is located the following path:

$MIPS_HOME/products/modis/subsets/USA1/jpeg/USA1.terra.20130218.01_04_03_01_01.jpg

The corresponding example true color jpeg subset image is located at:

$HOME/mips_test_products_compare/modis/subsets/USA1/jpeg/USA1.terra.20130218.01_04_03_01_01.jpg

These two images should look very similar.

Compare the following jpeg subsets images with the corresponding example jpeg subset images:

$MIPS_HOME/products/modis/subsets/USA1/jpeg/USA1.aqua.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA1/jpeg/USA1.aqua.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA1/jpeg/USA1.terra.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA1/jpeg/USA1.terra.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA2/jpeg/USA2.terra.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA2/jpeg/USA2.terra.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA3/jpeg/USA3.aqua.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA3/jpeg/USA3.aqua.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA3/jpeg/USA3.terra.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA3/jpeg/USA3.terra.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA4/jpeg/USA4.aqua.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA4/jpeg/USA4.aqua.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA4/jpeg/USA4.terra.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA4/jpeg/USA4.terra.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA5/jpeg/USA5.aqua.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA5/jpeg/USA5.aqua.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA7/jpeg/USA7.terra.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA7/jpeg/USA7.terra.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA8/jpeg/USA8.aqua.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA8/jpeg/USA8.aqua.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/modis/subsets/USA8/jpeg/USA8.terra.20130218.01_04_03_01_01.jpg
$MIPS_HOME/products/modis/subsets/USA8/jpeg/USA8.terra.20130218.07_02_01_02_02.jpg
$MIPS_HOME/products/viirs/subsets/USA1/jpeg/USA1.npp.20130218.05_04_03_05_12.jpg
$MIPS_HOME/products/viirs/subsets/USA1/jpeg/USA1.npp.20130218.11_07_05_07_07.jpg
$MIPS_HOME/products/viirs/subsets/USA2/jpeg/USA2.npp.20130218.05_04_03_05_12.jpg
$MIPS_HOME/products/viirs/subsets/USA2/jpeg/USA2.npp.20130218.11_07_05_07_07.jpg
$MIPS_HOME/products/viirs/subsets/USA3/jpeg/USA3.npp.20130218.05_04_03_05_12.jpg
$MIPS_HOME/products/viirs/subsets/USA3/jpeg/USA3.npp.20130218.11_07_05_07_07.jpg
$MIPS_HOME/products/viirs/subsets/USA4/jpeg/USA4.npp.20130218.05_04_03_05_12.jpg
$MIPS_HOME/products/viirs/subsets/USA4/jpeg/USA4.npp.20130218.11_07_05_07_07.jpg
$MIPS_HOME/products/viirs/subsets/USA5/jpeg/USA5.npp.20130218.05_04_03_05_12.jpg
$MIPS_HOME/products/viirs/subsets/USA5/jpeg/USA5.npp.20130218.11_07_05_07_07.jpg
$MIPS_HOME/products/viirs/subsets/USA6/jpeg/USA6.npp.20130218.05_04_03_05_12.jpg
$MIPS_HOME/products/viirs/subsets/USA6/jpeg/USA6.npp.20130218.11_07_05_07_07.jpg
$MIPS_HOME/products/viirs/subsets/USA7/jpeg/USA7.npp.20130218.05_04_03_05_12.jpg
$MIPS_HOME/products/viirs/subsets/USA7/jpeg/USA7.npp.20130218.11_07_05_07_07.jpg
$MIPS_HOME/products/viirs/subsets/USA8/jpeg/USA8.npp.20130218.05_04_03_05_12.jpg
$MIPS_HOME/products/viirs/subsets/USA8/jpeg/USA8.npp.20130218.11_07_05_07_07.jpg

Compare the following tiff subset images with the corresponding example tiff subset images:

$MIPS_HOME/products/modis/subsets/USA1/tiff/USA1.aqua.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA1/tiff/USA1.aqua.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA1/tiff/USA1.terra.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA1/tiff/USA1.terra.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA2/tiff/USA2.terra.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA2/tiff/USA2.terra.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA3/tiff/USA3.aqua.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA3/tiff/USA3.aqua.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA3/tiff/USA3.terra.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA3/tiff/USA3.terra.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA4/tiff/USA4.aqua.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA4/tiff/USA4.aqua.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA4/tiff/USA4.terra.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA4/tiff/USA4.terra.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA5/tiff/USA5.aqua.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA5/tiff/USA5.aqua.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA7/tiff/USA7.terra.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA7/tiff/USA7.terra.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA8/tiff/USA8.aqua.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA8/tiff/USA8.aqua.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/modis/subsets/USA8/tiff/USA8.terra.20130218.01_04_03_01_01.tif
$MIPS_HOME/products/modis/subsets/USA8/tiff/USA8.terra.20130218.07_02_01_02_02.tif
$MIPS_HOME/products/viirs/subsets/USA1/tiff/USA1.npp.20130218.05_04_03_05_12.tif
$MIPS_HOME/products/viirs/subsets/USA1/tiff/USA1.npp.20130218.11_07_05_07_07.tif
$MIPS_HOME/products/viirs/subsets/USA2/tiff/USA2.npp.20130218.05_04_03_05_12.tif
$MIPS_HOME/products/viirs/subsets/USA2/tiff/USA2.npp.20130218.11_07_05_07_07.tif
$MIPS_HOME/products/viirs/subsets/USA3/tiff/USA3.npp.20130218.05_04_03_05_12.tif
$MIPS_HOME/products/viirs/subsets/USA3/tiff/USA3.npp.20130218.11_07_05_07_07.tif
$MIPS_HOME/products/viirs/subsets/USA4/tiff/USA4.npp.20130218.05_04_03_05_12.tif
$MIPS_HOME/products/viirs/subsets/USA4/tiff/USA4.npp.20130218.11_07_05_07_07.tif
$MIPS_HOME/products/viirs/subsets/USA5/tiff/USA5.npp.20130218.05_04_03_05_12.tif
$MIPS_HOME/products/viirs/subsets/USA5/tiff/USA5.npp.20130218.11_07_05_07_07.tif
$MIPS_HOME/products/viirs/subsets/USA6/tiff/USA6.npp.20130218.05_04_03_05_12.tif
$MIPS_HOME/products/viirs/subsets/USA6/tiff/USA6.npp.20130218.11_07_05_07_07.tif
$MIPS_HOME/products/viirs/subsets/USA7/tiff/USA7.npp.20130218.05_04_03_05_12.tif
$MIPS_HOME/products/viirs/subsets/USA7/tiff/USA7.npp.20130218.11_07_05_07_07.tif
$MIPS_HOME/products/viirs/subsets/USA8/tiff/USA8.npp.20130218.05_04_03_05_12.tif
$MIPS_HOME/products/viirs/subsets/USA8/tiff/USA8.npp.20130218.11_07_05_07_07.tif

Quick start instructions

Create a directory for MIPS and download the necessary tar files into the MIPS directory:

mkdir $HOME/mips
cd $HOME/mips

Download the MIPS test and installation tar files:

FTP_LINK_STR=ftp://ftp.ssec.wisc.edu/pub/willemm/mips.version.2.1.public
mkdir mips_test_products_compare
cd mips_test_products_compare
wget $FTP_LINK_STR/mips_test_products_compare/mips_modis_test_compare.tar
wget $FTP_LINK_STR/mips_test_products_compare/mips_viirs_test_compare.tar
cd ../
wget $FTP_LINK_STR/mips_test_data.tar
wget $FTP_LINK_STR/mips_compile_binaries.tar
wget $FTP_LINK_STR/mips.version.2.1.public.tar.bz2

Unpack the MIPS tar files:

cd mips_test_products_compare
tar xf mips_modis_test_compare.tar
tar xf mips_viirs_test_compare.tar
cd ../
tar xf mips_test_data.tar
tar xf mips_compile_binaries.tar
tar xf mips.version.2.1.public.tar.bz2

If all the tar files were successfully extracted, remove the tar files to save disk space. Now set following environment variables:

export MIPS_INSTALL_DIR=$HOME/mips
export MIPS_HOME=$MIPS_INSTALL_DIR/mips.version.2.1.public

Create a scratch directory where all the temporary files can be stored, for example:

export SCRATCH_DIR=$HOME/scratch
mkdir $SCRATCH_DIR

Note

Make sure that about 100 GB of disk space is available for the scratch directory and the $MIPS_HOME directory.

Next the program distributed with MIPS has to be compiled. For Ubuntu 12.04 execute:

mkdir -p $SCRATCH_DIR/compile
/bin/bash $MIPS_HOME/scripts/utilities/compile_binaries_ubuntu_12_04.bash \
    $MIPS_INSTALL_DIR/mips_compile_binaries \
    $SCRATCH_DIR/compile \
    $MIPS_HOME/bin &> $MIPS_INSTALL_DIR/compile_log.log

And for Redhat 6.4 execute:

mkdir -p $SCRATCH_DIR/compile
/bin/bash $MIPS_HOME/scripts/utilities/compile_binaries_red_hat_6_4.bash \
    $MIPS_INSTALL_DIR/mips_compile_binaries \
    $SCRATCH_DIR/compile \
    $MIPS_HOME/bin &> $MIPS_INSTALL_DIR/compile_log.log

Make sure that all the program have been compiled by checking if the following binaries are in the MIPS binary directory:

ls -1 $MIPS_HOME/bin
bc
crefl.1.7.1
cs2cs
fornav
geotifcp
h5dump
listgeo
ll2cr
ncdump
tbase.hdf

The next step is to test MIPS. Follow the instructions given in section Testing MIPS.

Quick start instructions CSIR

Create a directory for MIPS and download the necessary tar files into the MIPS directory:

mkdir $HOME/mips
cd $HOME/mips

Copy the mips_test_data directory is in the $HOME/mips directory. If you lost by accident the mips_test_data directory, you can download it from:

FTP_LINK_STR=ftp://ftp.ssec.wisc.edu/pub/willemm/mips.version.2.1.public
wget $FTP_LINK_STR/mips_test_data.tar
tar xf mips_test_data.tar
rm mips_test_data.tar

Next download the MIPS test and installation tar files:

FTP_LINK_STR=ftp://ftp.ssec.wisc.edu/pub/willemm/mips.version.2.1.public
cd $HOME/mips
mkdir mips_test_products_compare
cd mips_test_products_compare
wget $FTP_LINK_STR/mips_test_products_compare/mips_modis_test_compare.tar
wget $FTP_LINK_STR/mips_test_products_compare/mips_viirs_test_compare.tar
cd ../
wget $FTP_LINK_STR/mips_compile_binaries.tar
wget $FTP_LINK_STR/mips.version.2.1.public.tar.bz2

Unpack the MIPS tar files:

cd mips_test_products_compare
tar xf mips_modis_test_compare.tar
tar xf mips_viirs_test_compare.tar
cd ../
tar xf mips_compile_binaries.tar
tar xf mips.version.2.1.public.tar.bz2

If all the tar files were successfully extracted, remove the tar files to save disk space. Now set following environment variables:

export MIPS_INSTALL_DIR=$HOME/mips
export MIPS_HOME=$MIPS_INSTALL_DIR/mips.version.2.1.public

Create a scratch directory where all the temporary files can be stored, for example:

export SCRATCH_DIR=$HOME/scratch
mkdir $SCRATCH_DIR

Note

Make sure that about 100 GB of disk space is available for the scratch directory and the $MIPS_HOME directory.

Next the program distributed with MIPS has to be compiled. For Ubuntu 12.04 execute:

mkdir -p $SCRATCH_DIR/compile
/bin/bash $MIPS_HOME/scripts/utilities/compile_binaries_ubuntu_12_04.bash \
    $MIPS_INSTALL_DIR/mips_compile_binaries \
    $SCRATCH_DIR/compile \
    $MIPS_HOME/bin &> $MIPS_INSTALL_DIR/compile_log.log

And for Redhat 6.4 execute:

mkdir -p $SCRATCH_DIR/compile
/bin/bash $MIPS_HOME/scripts/utilities/compile_binaries_red_hat_6_4.bash \
    $MIPS_INSTALL_DIR/mips_compile_binaries \
    $SCRATCH_DIR/compile \
    $MIPS_HOME/bin &> $MIPS_INSTALL_DIR/compile_log.log

Make sure that all the program have been compiled by checking if the following binaries are in the MIPS binary directory:

ls -1 $MIPS_HOME/bin
bc
crefl.1.7.1
cs2cs
fornav
geotifcp
h5dump
listgeo
ll2cr
ncdump
tbase.hdf

The next step is to test MIPS. Follow the instructions given in section Testing MIPS; Refer to:

$MIPS_HOME/doc/document.html#testing-mips

Necessary packages to be installed on Ubuntu 12.04

sudo apt-get install build-essential gfortran byacc flex libtirpc-dev