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.
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.
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.
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.
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.
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.
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
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
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 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.
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>
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
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 |
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.
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>
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
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.
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
Separate scripts have to be executed for VIIRS and MODIS 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
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
Mention path and false color combination.
$MIPS_HOME/scripts/process_mosaic.bash
Mention path and false color combination.
$MIPS_HOME/scripts/process_polar_mosaic.bash
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:
- Execute test processing script and check for any errors. Section Processing the test granules will explain how to execute this script.
- 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.
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!
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
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
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
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.
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
sudo apt-get install build-essential gfortran byacc flex libtirpc-dev