When installing HDFLook on your computer, the HDFLook.ad file is placed in the system directory:

/usr/lib/X11/app-defaults

by the superuser. It must be readable by all users.

If you can't modify the file, you can implement it locally by using the command:

xrdb -merge HDFLook.ad

In the panels, use the left mouse button to select the options, to activate the push buttons or to point to a position on the request of the software.
Any character string in an editor can be selected using the same button and then pasted into another editor using the central button.

At the first use of HDFLook, the user has to define two environment variables with:
- the absolute path of the directory containing the coast, river maps data files.
- the absolute path of the directory used temporary files.
, for example: in csh:
        setenv HDFLOOKMAPS /usr/local/Maps
        setenv HDFLOOKTMP /usr/tmp
or , for example: in sh:
        HDFLOOKMAPS=/usr/local/Maps ; export HDFLOOKMAPS         HDFLOOKTMP=/usr/tmp ; export HDFLOOKTMP

==========================================================

1.1  Files Read

FILE->READ

1.1.1  Working Directories

The working directory is shown in the editor at the top of the window. You can directly type a new directory in the editor (and press return) or click on the desired directory in the Unix file structure displayed.

Selection

Moves to the editor directory and refreshes the file scrolled list.

..

Moves a directory upwards.

$home

Loads your home directory.

$cwd

Loads the directory from which HDFLook is being run.

ex:

	Type:	the head of the list will be:
	*data	all the files ending with ``data''.
	data*	all the files beginning by ``data''.
	*data*	all the files having ``data'' in their name.

When you select one of the HDF files in the ``Directory content'' list:

* The widget ``HDF (raster image ) content'' may show a list of all of the 8 bit encoded images with their own look up table or the 24 bit images in true color. You may select one of those images and activate ``Show the selected raster image'' to visualize it.
See §1.3 for details of this menu.


* A new widget is opened with the
``Name_of_last_directory/Name_of_file''
as title and shows the other records: SDS and Vdata of the HDF main file.

1.1.2  Description of selection Menu

The window ``SDS list'' shows the name of the various SDS and Vdata records contents in the HDF file

By choosing one of the records and selecting ``show attributes'', the resizable window ``HDF_attributes'' appears; it contains the information record associated to the SDS file. Important parameters include the type of data, the calibration, the mask values:

Data type	16-bit unsigned integer
long_name	Land Reflectances Averaged on 10x10 Pixel Array
scale_factor	10000
add_offset	0
valid_range	0, 30000
_FillValue	90000

Options of the Menu:

• ``No predefined scaling''
  Several options allow the user to apply the scale factors set by attributes (Scale_factor , add_offset). These factors are not always implemented.

• ``Automatic mask detection''
  This option allows the user to generate in primary colours the constant value area introduced as mask values into the images.

• ``... DUMP RAW DATA...''
  

  • This option allows the user to create files containing various image slices, in binary without headers or trailers. An ASCII file, with the attribute .met, containing the characteristics of the created files is added.

    For example: for this SDS :
    3: ( 5 x 2708 x 130 ) EV_500_RefSB
    Is going to generate 5 files of 2708 lines of 4060 columns

    EV_500_RefSB_1
    EV_500_RefSB_2
    :
    EV_500_RefSB_5

    and a file:

    EV_500_RefSB_2708x4060.met

  • ``Dump a selected SDS on HDF file...''
    This option extracts a SDS to a HDF file with the indexes by slices.

• ``Show SDS as values''
  This option dumps the files in the same geometry shown in the main display window ``Show SDS as an image'' (for example an image 4x100x100 will be represented as a global image (2 raw images x 2 column images). The user can enlarge the window HDF_show_values to display more data.
  Rigth bottom sliders allow the user to move into a 50 × 50 sub-matrix. Left and top sliders allow the user to move the 50 × 50 sub-matrix into the global image.

   File size 260X100 Show size 79 -> 129 X 20 -> 70
          01-  79:01-  80:01-  81:01-  82:01-  83:01-  84:01-  85:01-  86:01-  87
  01-  20:
  01-  21:  
  01-  22: 
  01-  23:
  

  The first line shows the sub-matrix position in the global image and means that, in the total image (260 × 100 pixels), the values are shown from column 79 to column 129 and from line 20 to line 70.

  The column notation at the top of the window:
  01- 79: Where 01 is the number of the image (X) in the global image,

  79: the number of the column within this image
  The line notation at the top of the window:
  01- 20:Where 01 is the number of the image (Y) in the global image,

  20: the number of the line within this image

  
  Data can be viewed in several types:

  • Decimal (default)
  • Hexadecimal
  • Binary
  • Character

• ``Show SDS as a plot''
  When this option is activated, a new menu appears: HDF_plot_SDS_indexes. This menu is detailed in §1.2.2.

• ``Show SDS as an image''
  When this option is activated: the image is shown and a new menu appears: HDF_set_stretch.

  This menu allows the user to adjust a part of the Look Up Table. It allows also the user to fix values as masks or to modify the colors of masks. This menu is detailed in §1.4.

• ``... SEND RAW DATA...''
  

This menu is detailed on page pageref.

==========================================================

1.2  Graphic menus and windows

1.2.1  HDF_plot_parameters

This menu is called by Curve->Settings or by Plot->Plot defaults.

• to adjust the properties of global parameter plots.
  

  • the colour ``Color Plot''
  • the type of line ``Line type''
  • the type of mark ``Mark type'' (cross, dot, ...)
  • the format of the labels.
    The C language formulation is used: %[.precision]conversion

    precision:	number of decimals for the formats f, e and E
    	number of digits for the formats g and G (6 per default)
    conversion:	g universal notation (i.e. d, f, or e)
    	G universal notation (i.e. D, F, or E)
    	f decimal notation (i.e. ' [-]dddd.ddd')
    	e exponential notation (i.e. ' [-]d.ddde+dd')
    	E exponential notation (i.e. ' [-]d.dddE+dd')

    
    example:
    

    12.65978	%g	Þ 12.6598
    	%f	Þ 12.659780
    	%.3f	Þ 12.660
    	%.2e	Þ 1.27e+01
    	%.0f	Þ 13
    	%+.1f	Þ +12.7
    12.00	%g	Þ 12

  • switch X or Y units into logarithmics scale ``Apply X Logarithmics''
  • select ``Set graphic add mode'': any new plot will be added in the plot window.
  • check the ``Mask value filter'' to discard the points defined as mask values.

1.2.2  HDF_plot_SDS_indexes

• To realize simple lines or columns plots of an image.
  Just fill the editors with the line and column to plot, select which index is the data to plot, and click on ``Draw selection''.

  For example, the SDS 3: ( 2 x 100 x 130 ) Avg_Refl, so 2 slices 100 x 130

  • First example: single transect plot
    Deselect the toggle ``Set X index''
    Select the toggle ``DATA'' corresponding to the index 130
    Type 1 in the editor corresponding to the index 2
    Type 2 in the editor corresponding to the index 100
    ``Draw selection''
    The line 2 of the slice 1 will be plotted.

  • Second example: bidimensional plot
    Select the toggle ``Set X index'' and ``Set Y index''
    In the X definition part:
    type 2 in the editor corresponding to index 2
    type 2 in the editor corresponding to index 100
    In the Y definition part:
    type 1 in the editor corresponding to index 2
    type 2 in the editor corresponding to index 100
    ``Draw selection''
    The line 2 of the image 2 will be drawn versus the line 2 of the image 1.

1.2.3  Plot Window

In the plot window, a serie of menus allows the user to:

Files Menu

``Files->Print''	prints the plots
``Files->Extract''	extracts the values as an ASCII file named ``ExtractData'' ``ExtractData01'' etc...

Settings Menu

``Settings->Title''	modifies the axes titles and the main plot title (see figure 1.1)
``Settings->Plot setting''	modifies the curve's parameters
``Settings->Axis setting''	modifies the axis's values

Math Menu

Misc Menu

``Misc->Clear Window''

erases all plots

Drawing_area Menu

``Drawing_area->Zoom''	enlarges a part of the plot
``Drawing_area->Rescale''	returns to the initial scales
``Drawing_area->Show values''	shows values selected with the mouse in the plot window. To stop the loop, press any of the mouse button.
``Drawing_area->Clear area''	erases the points of a mouse selected zone: select an area by dragging with the left mouse button.

==========================================================

1.3  Image Visualization

File Menu

• FILE->READ
  Executes the main menu to read HDF files (see the §1.1).
  

• FILE->PRINT
  

  Starts the print menu for the image display: HDF_print.

  This choice generates PostScript files sent directly to a printer or stored on disk:

  • Send to printer
  • Save as PostScript file
  • Save as Encapsulated PostScript file (preferred format for insertion of the result in a document (Word, Tex, etc..))

  This choice contains various options concerning:

  • the paper size
  • the type of printing: Portrait or Landscape
  • the type of printer (grey scale or color) and its resolution in ``dots per inch''
  • the number of copies

• FILE->CLOSE
  This choice closes the image window.

Window Menu

• WINDOW->ZOOM
  Enlarges a mouse selected zone of the image.
  

• WINDOW->FULL IMAGE
  Returns to the initial image after a zoom.
  

• WINDOW->SCROLL ZOOM
  Creates a small scroll window:
  • The middle button selects the area in the main window
  • The left button enlarges the area to show
  • The right button reduces the area to show

  If the toggle ``Freeze contrast'' is set, the images are always computed with the same minimum and maximum. Otherwise, minimum and maximum are computed for each selection and the contrast changes at every selection.

  The red cross in the scroll window shows the pixel whose value is printed in the editor. You can click pixels in the scroll window to display their values.

  To stop the scroll window visualization the XWindow Close panel is used.

• WINDOW->CURSOR VALUES
  

  Displays a small 3x3 or 5x5 or 9x9 zone of values. Click in the main image to change the pixels displayed.

  The values can be displayed in Decimal, Hexadecimal or Binary. In the case of a SDS with more than two indexes, the option ``All layers'' switches the display to slice mode.

Color Menu

• Color->Contrast stretch
  Activates the menu HDF_set_strech See the §1.4.
  

• Color->Color palette
  Changes the Loop Up Table. (14 Loop Up Tables are implemented)

Plot Menu

• Plot->transect
  Draws, using the mouse, a radial in the main image and plots the values as a curve.

• Plot->histogram
  Draws a zone in the image and computes the histogram of the values. The menu ``HDF_plot_parameters'' (see below) allows the user to fix the minimum and maximum of the histogram and the size of the classes. Do not forget to filter the masked values in some case using the option ``Mask value filter''

• Plot->defaults
  Launches the menu Hdf_plot_parameters detailed in §1.2.1.
  

Msphinx Menu

HDFLook , launched by Msphinx , allows you to exchange data. Two modes are avalaible:

• direct transfer of data for small volumes.
• creation or modification of Msphinx project. The transfers will use the Msphinx project with data planes stored on disk.

More explanations in the chapter 2.16.2.

Help Menu

==========================================================

1.4  Look-Up Table Stretch

Color->HDF_set_stretch

• Modification of the range of the data displayed:
  • ``Low cut-off'' ``High cut-off''
    If the two values are identical (for example: -1) the data is automatically stretched between the two values printed in the right of the editors (1% and 99 % of the data). A histogram shows the distribution of the data with regard to the 256 levels of the color scale.

    Fill the ``Low cut-off'' ``High cut-off'' editors and execute ``Apply''. The main window shows the new range of data, split in 256 levels of colour.

  • ``Select Area''
    You can select one area of the image to compute the histogram showing the correlation between data and colour.
    Activate ``Select Area''
    Select the zone in the main window using the button mouse.

  • ``Mouse cut-off selection''
    You can fill the editors ``Low cut-off'' ``High cut-off'' using the histogram; activate ``Mouse cut-off sélection''; draw a vertical line in the histogram window on the interesting range and execute ``Apply''.
    To return to the original computed values just clear or fill the editors ``Low cut-off'' ``High cut-off'' with an identical value, then select ``Apply''.

  • Change the mask values filter:
    The list ``Mask values'' shows the masks values with their colour and the approximate percentage of pixels concerned, for example:
    

    		90000     Magenta     41.95%
    

    You can add a value by typing it in the list, eg:
    

    		50000     Red
    

    Then activate ``Apply''; giving us:

                    90000     Magenta     41.95%
                    50000     Red          0.00%
    

    There are no pixels having a value of 50000. You can change the colour directly in the list, for example:

                    90000     Yellow
    

    then activate ``Apply''; the mask turns to yellow. To return to the initial values, activate the button ``Reset mask''.

Description

HDFlook is designed to recognize different MODIS HDF-EOS files. The action of clicking on the file name will open several MODIS additional menus and options.
Three types of images can be displayed:

- RGB composite
- thermal anomalies composite
- thermal composite
- single plane (LUT) image

The user is able to visualize with reprojection or not.

Level1B	A RGB composite standard atmospheric corrected image. A RGB composite ``thermal'' anomalies. A RGB composite ``thermal''. A single plane.
Mod09	A RGB composite standard atmospheric corrected image. A single plane.
Other products	A single plane (with latitude, longitude SDS records).
Other products	A single plane (reprojected SDS records).

Level1B (1km):

The software tries to find latitude,longitude SDS records with the best accuracy in the corresponding Level1B (500m, 250m) or MOD03 HDF files. (if not, the software uses the coarse latitude,longitude SDS records to compute the 1km resolution. See appendix A.1 for accuracy evaluation.)

Level1B (250m):

To build a RGB image, the software needs the Level1B 1km or MOD03 HDF files and the Level1B 500m HDF files.

Important:

to help HDFlook to find the other Level1B or MOD03 files, the user must fill the ``Set associated directories'' textlist with the path of the different directories containing the HDF corresponding files.

==========================================================

MODIS Options

The ``file menu contents'' shows a map with the granule location. Several text labels give the latitude and longitude location, the HDFLook current selected projection, the internal HDF-EOS flags (day, night, mixed).
warning: HDFlook does not change the SDS original data structure: night data are flipped (north-bottom, south-top).

This menu works using several other options selected in the menus or with buttons. The explanations are below.

==========================================================

2.1  Enhance RGB image

This menu defines the color scale used in the RGB image mode:

2.1.1  Enhance RGB image

2.1.2  Set RGB mode to ...

• Set RGB mode to linear
• Set RGB mode to log
• Set RGB mode to coarse log
  In this mode, the atmospheric corrections are not applied and the (blue color) Rayleigh effect can be seen.

==========================================================

2.2  Reprojection

2.2.1  Reprojection geometry

Set associated directories

Set map addings

Adds to the displayed image several projected countours from implemented data files. ( MGBOUNDARIES_MAP, MGRIVERS_MAP_*, MGWORLD_MAP) At the first use of HDFLook, the user has to define an environment variable with the path of the directory containing those data files.
ex: in csh:
        setenv HDFLOOKMAPS /usr/local/Maps
or ex: in sh:
        HDFLOOKMAPS=/usr/local/Maps ; export HDFLOOKMAPS

Set grid addings

Adds to the displayed image the latitude and longitude grids.

==========================================================

2.3  No predefined scaling

This option allows the user to apply the scale factors set by attributes. (Scale_factor , add_offset) (These factors are not always implemented).

==========================================================

2.4  Automatic mask detection

This option allows the user to generate in primary colours the constant value area introduced as mask values into the images.

==========================================================

2.5  Set preview

If this option is activated, each HDF-EOS (Level1B,MOD09) file selection will display a small RGB image to show the granule.

==========================================================

2.6  RGB defaults

A set of three stretch values is provided for the RGB enhance image to make a fast test.

* Standard
* Desert
* Pole

==========================================================

2.7  Show SDS as values

This option dumps the files in the same geometry shown in the main display window ``Show SDS as an image'' (for example an image 4x100x100 will be represented as a global image (2 raw images x 2 column images). The user can enlarge the window HDF_show_values to display more data.
The right and the bottom sliders allow the user to move into a 50 × 50 sub-matrix (See §1.1.2).

==========================================================

2.8  Show SDS as a plot

When this option is activated, a new menu appears: HDF_plot_SDS_indexes. This menu is detailed in §1.2.1.

==========================================================

2.9  AERONET

When this option is activated, a new menu appears: Msky_look.
This menu is detailed page pageref

==========================================================

2.10  Send raw data

This menu appears when HDFLook is sent by Msphinx . It allows the user to send one or several SDS to the Msphinx data structure. Two modes, raw data or reprojected data, are allowed. In this case, the maps can be added in the graphic overlay of Msphinx .

- ``Quick ...'' is related with the SDS selected in the ``SDS list'' of the HDF file content panel.
- ``Advance ...'' is used for several SDS selections.

``Send raw data'' options are available for any HDF file. The user is able to send raw or calibrated data. No sampling is allowed.

2.10.1  Quick send to Msphinx

The user is able to select the Msphinx plane and geometry where the data will be dropped in the Msphinx memory. Two labels (width, height) show the size of the SDS to be sended. If the SDS doesn't fit the cell geometry defined in the editors (x,y,width,height), the option ``Fit file size to cell'' can be activated.
When a SDS is more than two dimensions and no value is done in the third dimension (for example: *,height,width) the user can create a single Msphinx plane with all the image slices (as the option ``Show SDS as an image'') or use several Mpshinx planes starting from the defined ``Plane nb'' activating the option ``Send by layers''.
Warning: if the data type (char,float) does not match the Msphinx data plane definition, the data will be transformed to the Msphinx data plane with, perhaps, a lost of accuracy.
See the §3.0.1 for more explanations.

2.10.2  Advance data send...

==========================================================

2.11  Dump raw data

This menu is related with the SDS selected in the ``SDS list'' of the HDF file content panel.
Dump raw data options are available for any HDF file.

2.11.1  Dump on file

• Dump a selected SDS to file ...
• Dump a selected SDS to HDF file ...

The user is able to sample the data by selecting start lines,columns and step lines,columns. For the MODIS/EOS format, the units can be entered in degrees (latitude,longitude). Data can be dumped as geophysical parameters in a floating point file.

2.11.2  MODIS reprojected image

- Create a JPEG(RGB) Image ...
- Create a HDF (RGB) Image ...
- Create a (RGB) MOSAIC Image...
- Create a JPEG(USER RGB) Image...
- Create a HDF(USER RGB) Image...
- Create a (USER RGB) MOSAIC Image...

In the menu ``Set projection geometry'', the user will define the global space (latitude, longitude) for the final mosaic and the matrix size (lines, columns). All the granules will overlap on the selected area location and size.
- Create a SDS JPEG Image ...
- Create a SDS HDF Image ...

In these menus, you can add a Color Scale with the corresponding annotations into the image. The label list contents the labels of the scale in the format: pixel value (0->255), annotation. (annotation is a value like ``23.12'' or text such as ``clouds'').
Options:
``Compute new label list.''
Compute a list of labels according with the image units. (If you change the scaling in the SDS content menu you have to activate this function to compute a new list).
``Up/left side.''
Default annotation are on the bottom or right side of the color scale. This option change to Up or Left side.
``Create scale.''
Create or move the scale in the image window.
``Apply change.''
If any option is modifided, select ``Redraw scale'' to validate the change.


- Dump a selected SDS on file ...
- Dump a selected SDS on HDF file ...
- Dump a selected SDS (MOSAIC) ...

==========================================================

2.12  Show SDS as an image

==========================================================

2.13  Display a MODIS reprojected image

2.13.1  Show (RGB) image

algorithm correction

This option builds for the level1B or Mod09 files a RGB composite image using band 1 (250m) ,band 4 (500m), band 3 (500m).
(See Standard atmospheric algorithm correction [1]& [2].)

2.13.2  Show (RGB) thermal anomalies

This option builds for the level1B or Mod09 files a RGB composite image.

The thermal anomaly RGB is using MODIS band 6 corrected reflectance in the green, band 7 corrected reflectance in the blue and the reflectance computed from band 20 (3.75mm) in the red. In band 20, the reflectance is computed following the method developed by Roger and Vermote for AVHRR [3]. This method is modified for MODIS by taking advantage of water vapor inversion using band 18 and 19 [4]and the derived reflectance validated by comparison to the full inversion of the reflectance. Qualitatively, the RGB thermal composite is a very useful and simple way to locate fire activity (see appendix A.4), where the thermal energy released by fires is interpreted as an extra reflectance contribution at 3.75mm (see [5]for details) and produces ``red'' spot on the image, the relative intensity of the red is directly proportional to the size and temperature of the fire.

2.13.3  Show (RGB) thermal

The thermal RGB is using MODIS band 31 in the Red 290K-275K, band 29 in the Green 280K-270K, band 20 in the blue 300K-285K. See the example in appendix A.3.

2.13.4  Show one layer

==========================================================

2.14  RGB User composite

2.14.1   RGB IMAGE BUILDER

Step by Step example:

Start the ``Show (RGB) User defined'' option from the ``Display a MODIS reprojected Image'' menu

Click the ``Multi SDS selection'' button to link data to RGB planes

SDS selection menu:

Select a SDS and link the SDS to the Red or Green or Blue image planes:

The solar zenith angle will be the red plane	The MODIS emissive chanel will be the green plane	The height will be the blue plane

Close the menu and select the final options:

1. The slice number from 1 to 15 of the SDS EV_1KM_Emissive (note: the notation 12,h,w is not necessary in this case). This notation is used to help the software to choice the image width and height indexes from complex data sets.
2. Complement Green bank: 0 will be 255
3. Select min max threshold for the Green and Blue banks

RESULT: The selected SDS have different pixel size and deep, the final image is in linear projection width coast map and boundaries.

Another example using 4 display windows

3 images are built with emissive bands and one (Upper left) with reflective Solar bands

==========================================================

2.15  CERES SSF Product

2.15.1   Underlying Principles

2.15.2   Interactive Mode

• select a HDF SF file in the ``HDF_read_files window'' (explore your directories with ../ , $home, $cwd )
• a new window ``CERESSSF/CERES_FILE'' opens showing the available parameters to be selected (close the 'attributes' window of minor interest),
  example of parameter : 39 is the LW TOA flux
  other example: 122 is the mean imager radiance over full CERES FOV
  if 122 is selected , the SDS has 2 dimensions with 5 slices, choice 4 for example which corresponds to the VIRS 10.8 channel, with the SET MAPPING button, you can choose the projection geometry (linear, mollweide, ..) and other grid and map options, go to the button ``Display a CERES reprojected image'' then ``show a layer''

• two windows will then appear the map window with a title according to the projection: linear, mollweide, . the ``HDF_set_stretch'' to change the color ranges through the histogram
• in the map window, the window submenu gives zoom and cursor value facility the HDF_pixel_value is powerful since all the parameter data are listed (see example below). The map can be printed or saved as PS or EPS files.

2.15.3   Batch Execution

==========================================================

2.16  AIRS Product

2.16.1   Step by Step

• Within the SDS LIST, select a large AIRS Dataset, select the scaling and the mask, then click on ``Show SDS as an image''

  Two panels appear: one for the band selection the other one for the data analyze. Missing data is clearly visible. A click on a small rectangle loads the AIRS_zoom panel with the wavelenght data.

• All windows are sensitive
  Selected pixels and drawings are allowed in any image panel of the software.
  • In the AIRS zoom panel the image geometry is the original SDS geometry.
  • However the user is able to reproject a band ``Show one layer'' from the ``Display AIRS reprojected image'' menu.
  • The new window will be sensitive to all AIRS analyze input options.

  Reprojected band with coast (green), boundaries (magenta) major rivers (red) and human activity (magenta)

• Plot Transect
  • Select ``Plot transect'' from the ``Plot menu''
  • Select ``Select plot area'' and draw a line into the zoom image

• Plot pixel spectrum
  • Select ``plot add mode pixel''
  • Select pixels

• Plot scatter diagram
  • Fill the editors with the X and Y band number
  • Select a plot area
  • The ``By pixel option'' is used to plot the diagram pixel by pixel

  The ``Get area from plot window'' is used to visualize the pixels having specific x/y properties.

  • Click on the ``Get area from plot window'' button
  • Select on the plot window an area of interest

  The corresponding pixels appear colored in magenta on the image window:

  Select ``Plot add mode''

  • change the Y index editor by 1000, click the ``Redraw same selected area''
  • change the Y index editor by 1200, click the ``Redraw same selected area''
  • ... etc...

2.16.2   Batch Execution

Communications with Msphinx

Sending images, read by HDFLook , to Msphinx is possible if you have launched HDFLook  from Msphinx . If you have launched HDFLook alone, the menus will be drawn in half tone or hidden.

2 modes are available:

* the direct transfer of data for small volumes.
* creation or modification of Msphinx project. The transfers will use the Msphinx project with data planes stored on disk.

3.0.3  Quick send to Msphinx

This menu presents the particularity to convert the data read by HDFLook in the type (char, short, int) of data of the selected Msphinx plane intended to receive data. (Warning in the truncation of data)

Warning: under certain circumstances, after sending data to the Msphinx data planes, the image visualisation into Msphinx does not appear. Start the Msphinx menu ``Display->Enhance display'' and activate ``Apply'' to rebuild the output image.

From standard HDF:	From MODIS SDS:

• Choose Msphinx's geometry

  To fill the editors of Msphinx reception geometry (X,Y,Width,Height) you can use:

  • Directly the editors ``Editor position''
  • The Msphinx cells ``Grid position''
  • An area selected with the mouse in the main Msphinx window ``Mouse position''
  • ``Fit file size to cell''
    Adjust the size of the SDS image to the Msphinx cell's geometry by sampling lines and columns.

• Select the data plane
  • Red plane
  • Green plane
  • Blue plane
  • RGB plane
  • Plane no (1->4095)

• Choose image to send

  the default option is the transfer of the image displayed in the HDFLook's main window (respecting the selected zoom or in image mosaic). In the case of a SDS with more than 2 indexes (mosaic of images), if you activate ``Send by layers'', a SDS slice will be transferred to the first receiving plane of Msphinx  and on the following ones (always respecting the selected zoom).

• Activate: ``Send data to Msphinx''

3.0.4  Advance data send

Advance data send will modify or create a complete Msphinx project with data stored on disk space.

This method will be generalized for the comparison of satellite data from different experiments. We have to work on improving its efficiency. This menu is called from the selection menu (see the §1.1.2 or in §2.10 in the MODIS chapter).

The menu, step by step:

1. At the top left,the name of the current project is printed. You can activate ``Change Msphinx project name'' to modify it.
   

   Two options:
   

   ``Project selected from Msphinx base'' The list of existing projects is shown. Select a project.Activate ``Apply'': the new geometry is displayed in the panel.	``User project define'' You can fill the 2 editors ``Project directory path'' and ``Project name'' Then activate ``Apply''. If the directory of the project is not $home/.Msphinx, a symbolic link is automatically created in the directory $home/.Msphinx to point at the new project. The default geometry will be the geometry of the SDS image selected.

2. you have to introduce the geometry of the image reception in the data planes of Msphinx :

   Activate ``Change Msphinx cell mapping''

   • directly fill the editors: X, Y, Width, Height
   • using the arrow, ``Select next cell'' will suggest you the places of possible arrangement taking into account the size of the image and the existing cells of the project.

3. Fill the editor ``Start plane no'' with the number of the first data plane which you want to fill. A list allows you to see planes already containing images and their data type. Please note: in this working mode, there is no conversion of data if truncations are possible. The transfer will be made only if the plans of Msphinx data already filled can contain the new data without truncation. For example:
   

   SDS:16 bits ->	Msphinx plane 32bit integer ->	no problem
   SDS: 32 bits real ->	Msphinx plane 16 bits ->	impossible

   At the bottom, on the right, you will find the characteristics of the SDS to be transferred:

             Width:      Height:      Format:        Slices:
   

4. A toggle ``Fit cell geometry'' allows images to be fit to the size of Msphinx's cell by sampling lines, columns.
   

5. Activate:
   • ``Clear all & Do it'' will erase all existing data.
   • ``Add/Modify data planes'' will add images.

4.1  Send raw data to MSPHINX

1. Start HDFlook from Msphinx.
2. Select a HDF-EOS File.
3. Start ``advance data send'' ``... SEND RAW DATA ...''
   All the HDF/SDS content is listed.

4. Select ``Change Msphinx project name''
   • Select ``User project define''
   • Type LOA in the editor ``Project name''
   • Start ``Apply''

5. Select ``Change Msphinx cell mapping''
   • type 1000 in the editor width
   • type 1000 in the editor height
   • Start ``create cell''
   • Start ``Cancel''

6. Type 1 in the editor ``Start plane nb''

7. Select ``Fit cell geometry''

8. Select some SDS's from the List.
   At each selection the software shows the type of data and the ``from and to'' planes of Msphinx .
   If a selection error is made, just click again on the erroneous SDS and this one is deleted from the selection.
9. Apply ``Clear all & do it''

4.2  Create a JPEG image on disk

1. start HDFLook
2. select a modis LEVEL1B 1km file:

3. set reprojection geometry
   • select ``linear''
   • fill width editor with 1000
   • clear height editor (it will keep the proportion w/h)
     Warning: in linear mode, if the image is over the pole, fill also the height editor with 1000
   • select ``show (Image area in the output projection geometry)'' (Just to see a map with the area)

4. ``set RGB mode to log'' (``Enhance RGB'' image menu)
   • set (RGB Defaults menu) to ``Pole'' for an image over snow Please note: Select ``Standard'' for an image over land

5. ``Show MODIS (RGB)'' (Display a MODIS reprojected image menu)

6. start ``Create a JPEG(RGB) Image'' (``...... Dump raw data menu .....'' ``... MODIS REPROJECTED IMAGE ...'')
7. ``Apply'' in the menu HDF_Export_Data

Exit HDFLook
xv the_image_file
cat the_image_file.met

==========================================================

SYNOPSIS

5.1  General Functions

5.1.1   Options of the command file

add_global_attr info="LOA-USTL"  type=UCHAR  value="Lille 1km RGB image" 
add_global_attr	info="Latitude"  type=FLOAT  value=52.05 
add_global_attr	info="Longitude" type=FLOAT  value=.05 

LINEAR,                 POLDER,                 GOODE,          MOLLWEIDEEA,
HAMMER[2],              AZIMUTHAL[1,2],         LAMBERT[1,2],   MILLER[2],
MOLLWEIDE[2],           ORTHOGRAPHIC[1,2],      ROBINSON[2],    SINUSOIDAL[2],
VANDERGRINTEN[2],       WAGNER7[2],             MODIS[2,7,8,9], NOPROJECTION

Color Lut Name:      GREY, RAINBOW0, RAINBOW1, RAINBOW2, RAINBOW3, RAINBOW4,
                     GEODESIC, SEISMIC, TOPOGRAPHIC, ADDITIVE, CEE, X11,
                     GREY16, RAINBOW16, NONE

clear_data
set_input_hdf_file              MOD021KM.A2000265.1145.002.2000267053723.hdf
set_projection_to_geometry      ProjectionTo="linear"
set_image_RGB_composite  	VISIBLE
send_to_PS_File  FileName="./printlinear.ps" Type=Color PaperFormat=A4  dpi=200\
                 Copies=1 Orientation=Portrait print=RGB \
                 PageTitle="MOD021KM.A2000265.1145.002.2000267053723" RGBMode="LOG"

clear_data
set_input_hdf_file              MOD021KM.A2001114.1445.002.2001127221453.hdf
set_projection_to_geometry      ProjectionTo="noprojection"
add_earth_icon                  xto=3 yto=3 width=3 height=3
set_image_RGB_composite  	VISIBLE
send_to_PS_File  FileName="./printnoreppole.ps" Type=Color PaperFormat=A4  dpi=200 \
                 Copies=1 Orientation=Portrait print=RGB \
                 PageTitle="MOD021KM.A2001114.1445.002.2001127221453" RGBMode="LOG"\
                 minR= 8.3 maxR = 9.3 minG= 8.3 maxG = 9.3 minB= 8.3 maxB = 9.3

verbose
clear_data

set_output_directory        /users/louis/CERES_COM/OUTPUTS/
set_input_directory         /users/louis/CERES

set_projection_to_geometry   ProjectionTo="LINEAR"    WidthTo=1000 HeightTo=500 \
				        LatitudeMinTo=-90.0000 LatitudeMaxTo=90.0000 \
					LongitudeMinTo=-180.0000 LongitudeMaxTo=180.0000

#=============================== IMAGE SETTING ======================================
set_color_scale_name        RAINBOW3
set_image_background        color=White
add_maps Coastlines=Yes Boundaries=Yes  CoastlineColor=Green BoundaryColor=Magenta
add_scale_to_image X=950 y=50 width=30 Height=150 TickColor=Black ForegroundColor=Black \
		BackgroundColor=white TextFormat="%.0f" FontName=Courb.ttf SizeFactor=.8 UpLeftSide=yes \
		NoTicks=yes Labels=" 0 0.00   64 75.0   128 150.0   192 226.0   255 300.0"
add_grids       color=Black LatitudeMin=-90  LatitudeMax=90 LatitudeStep=30 \
                LongitudeMin=-180 LongitudeMax=180 LongitudeStep=30
#=============================== SELECT SDS     ======================================

select_SDS                 SDSName= "CERES LW TOA flux - upwards"
set_SDS_enhance min=0 max=300

#=============================== TITLES         ======================================
add_text x= 100 y = 15 ForegroundColor="Black" BackgroundColor="White" Border=0 FontName=Courb.ttf \
                     SizeFactor=1.5 Rotation=0. text="CER_SSF_TRMM-PFM-VIRS_Edition2B-TransOps_021018.1999030905"
add_text x= 300 y = 480 ForegroundColor="Black" BackgroundColor="white" Border=0 FontName=Courb.ttf \
                     SizeFactor=1.5 Rotation=0. text="CERES LW TOA flux - upwards"

set_input_hdf_file         /users/louis/CERES/CER_SSF_TRM*
create_MODIS_SDS_MOSAIC_image       FileName="CERES_MOSAIC" ClearFile=Yes  CreateJPEG=yes
    

verbose
clear_data

set_output_directory        /users/louis/CERES_COM/OUTPUTS/
set_input_directory         /users/louis/CERES

set_projection_to_geometry   ProjectionTo="LINEAR"    WidthTo=1000 HeightTo=1000 \
                                        LatitudeMinTo=-8.0000 LatitudeMaxTo=50.0000 \
                                        LongitudeMinTo=-30.0000 LongitudeMaxTo=28.0000

#=============================== IMAGE SETTING ======================================
set_color_scale_name        RAINBOW3
set_image_background        color=White
add_maps Coastlines=Yes Boundaries=Yes  CoastlineColor=GREEN BoundaryColor=Magenta
add_scale_to_image X=50 y=750 width=30 Height=150 TickColor=Black ForegroundColor=Black \
		BackgroundColor=white TextFormat="%.0f" FontName=Courb.ttf SizeFactor=.8 UpLeftSide=yes \
		NoTicks=yes Labels=" 0 0.00   64 75.0   128 150.0   192 226.0   255 300.0"
add_grids       color=Black LatitudeMin=-90  LatitudeMax=90 LatitudeStep=30 \
                LongitudeMin=-180 LongitudeMax=180 LongitudeStep=30
#=============================== SELECT SDS     ======================================

select_SDS                 SDSName= "CERES LW TOA flux - upwards"
set_SDS_enhance min=0 max=300

#=============================== TITLES         ======================================
add_text x= 100 y = 15 ForegroundColor="Black" BackgroundColor="White" Border=0 FontName=Courb.ttf \
                     SizeFactor=1.5 Rotation=0. text="CER_SSF_TRMM-PFM-VIRS_Edition2B-TransOps_021018.1999030905"
add_text x= 30 y = 950 ForegroundColor="Black" BackgroundColor="white" Border=0 FontName=Courb.ttf \
                     SizeFactor=1.5 Rotation=0. text="CERES LW TOA flux - upwards"

set_input_hdf_file         /users/louis/CERES/CER_SSF_TRM*
create_MODIS_SDS_MOSAIC_image       FileName="CERES_MOSAIC_Z" ClearFile=Yes  CreateJPEG=yes
    

verbose
clear_data

set_output_directory        /users/louis/CERES_COM/OUTPUTS/
set_input_directory         /users/louis/CERES

set_projection_to_geometry   ProjectionTo="ORTHOGRAPHIC"    WidthTo=1000 HeightTo=1000 \
					CenterLatitudeTo=0 CenterLongitudeTo=0 \
				        LatitudeMinTo=-90.0000 LatitudeMaxTo=90.0000 \
					LongitudeMinTo=-180.0000 LongitudeMaxTo=180.0000

#=============================== IMAGE SETTING ======================================
set_color_scale_name        RAINBOW3
set_image_background        color=White
add_maps Coastlines=Yes Boundaries=Yes  CoastlineColor=Green BoundaryColor=Magenta
add_scale_to_image X=950 y=50 width=30 Height=150 TickColor=Black ForegroundColor=Black \
		BackgroundColor=white TextFormat="%.0f" FontName=Courb.ttf SizeFactor=.8 UpLeftSide=yes \
		NoTicks=yes Labels=" 0 0.00   64 75.0   128 150.0   192 226.0   255 300.0"
add_grids       color=Black LatitudeMin=-90  LatitudeMax=90 LatitudeStep=30 \
                LongitudeMin=-180 LongitudeMax=180 LongitudeStep=30
#=============================== SELECT SDS     ======================================

select_SDS                 SDSName= "CERES LW TOA flux - upwards"
set_SDS_enhance min=0 max=300

#=============================== TITLES         ======================================
add_text x= 100 y = 15 ForegroundColor="Black" BackgroundColor="White" Border=0 FontName=Courb.ttf \
                     SizeFactor=1.5 Rotation=0. text="CER_SSF_TRMM-PFM-VIRS_Edition2B-TransOps_021018.1999030905"
add_text x= 300 y = 480 ForegroundColor="Black" BackgroundColor="white" Border=0 FontName=Courb.ttf \
                     SizeFactor=1.5 Rotation=0. text="CERES LW TOA flux - upwards"

set_input_hdf_file         /users/louis/CERES/CER_SSF_TRM*
create_MODIS_SDS_MOSAIC_image       FileName="CERES_MOSAIC_ORTHO" ClearFile=Yes  CreateJPEG=yes
    

#           Create a reprojected MOSAIC file from a set of AIRS HDF files
#=========================================================================

verbose
clear_data
set_output_directory            /data2/home/louis/OUTPUTS
set_input_directory             /net/bratmos/data4/dayTime/

set_projection_to_geometry ProjectionTo="LINEAR"  WidthTo=3000 HeightTo= 1500\
                        LatitudeMinTo=-90.0 LatitudeMaxTo=90.0 \
                        LongitudeMinTo=-180.0 LongitudeMaxTo=180.0


#  ======================   jpeg control file settings === CreateJPEG=yes =================
add_maps        Coastlines=yes Rivers=No Boundaries=No CoastlineColor=Green 

add_grids    color=Black LatitudeMin=-90 LatitudeMax=90 LatitudeStep=10 \
		LongitudeMin=-180 LongitudeMax=180 LongitudeStep=10

add_text     x= 10 y=30 ForegroundColor="Black"  BackgroundColor="TRANSPARENT" \
		Border=0   FontName="Bell.ttf" SizeFactor=3.0 Rotation=0.0 \
		"AIRS (Day) TSurfStd (HDFlook_MODIS Mosaic)"


add_latitude_labels    ForegroundColor="Red" BackgroundColor="TRANSPARENT" Border=0 FontName="Bell.ttf" \
                        SizeFactor=1.5 Rotation=0. Format="%.1f" \
                        Longitude=-160 LatitudeMin=-90  LatitudeMax=90 LatitudeStep=20

add_longitude_labels   ForegroundColor="Red" BackgroundColor="TRANSPARENT" Border=0 FontName="Bell.ttf" \
                        SizeFactor=1.5 Rotation=0. Format="%.1f" \
                        Latitude=-80 LongitudeMin=-180 LongitudeMax=180 LongitudeStep=20

add_scale_to_image      x=2200 y=50 width=400 height=100 \
                        TickColor=white  ForegroundColor=Black backgroundColor=White \
                        TextFormat="%.1f" FontName=Courb.ttf SizeFactor=1.2 \
                        UpLeftSide=Yes NoTicks=No \
        		Labels="0  computed    63 computed   127 computed 191 computed 255 computed"

set_color_scale_name    RAINBOW0
set_image_background    color=white

set_SDS_enhance min=220 max=320

#  ========================================================================================
select_SDS                      SDSname="TSurfStd"
set_input_hdf_file              /net/bratmos/data4/dayTime/AIRS.2000*
create_MODIS_SDS_Mosaic     FileName="AIRSDayTSurfStd"   ClearFile=Yes BottomPixelFiller=2 CreateJPEG=yes