|
ImageMapper™
User's Guide
Version 2.0 February 2004
|
|
Copyright (C) 2004 Surface Optics
Corporation (SOC). United States Copyright Law and International
Treaty protect this SOC proprietary software and documentation.
All rights reserved.
|
|
1.0 Overview
|
1.1 What is ImageMapper ?
ImageMapper, by Surface Optics Corporation's (SOC),
is a user-friendly software package for defining
the material composition of image pixels based on their
spectra. Knowing the material composition of a pixel and
the related properties of those materials allows realistic
sensor simulation across the electro-magnetic spectrum.
ImageMapper outputs Material Composition Maps
(MCM). MCMs describe the mixture and relative proportion
of materials within a pixel. This is a significant
improvement in sensor simlation over the use of cartographic
products such as VPF and Land-Use/Land Cover data, which
assign a single material to every pixel.
ImageMapper is simple and easy to use. An analyst
displays an image, provides the software with
a set of reference or training pixels by pointing and
clicking in the image and ImageMapper takes care
of the rest. Based on the associations made by the analyst
for a few basis pixels,
the software determines the mixture and proportions of
materials for every other pixel in the image. This is sometimes
referred to as sub-pixel classification.
ImageMapper also includes
- A rendering engine for producing color, reflectance
and radiance images based on the derived MCMs. This
provides immediate feedback to the analyst for refinement,
correction and quality assurance purposes. Renderings
can also be used directly in sensor simulation systems.
- A set of region definition tools which add
a spatial component to the classification
- A set of simple image processing utilities
- A set of basic materials with reflectance measurements
from 0.4 to 14 microns.
- Additional tools, data and measurement services to
support sensor simulations and trade studies.
- A workbench for analyzing material properties
data for contrast studies.
- A full rendering package which includes a radiative
transfer model.
- Compatibility with SOC's materials database containing high quality measurements
for 200 of the most common materials in
the environment.
- Material properties measurement services
1.2 Why Material Composition Maps?
In contrast to single 'thematic' layers which are typical
in cartographic data, MCMs capture the sub-pixel mixturing
of materials in a pixel. Just as polygons gave way to
the use of textures (per pixel color) for greater visual
detail and realism, thematic layers (which are often described
as a mix of polygonal, linear and point features) will
give way to MCMs which capture the per-pixel variation
of materials in an image.
When rendered, thematic layers produce an image in which
a 'tree stand' appears as a single color or radiance value
over a defined region, leading to a 'map' like appearance.
In contrast, MCMs contain material mixtures based on the
original image on a per pixel basis. This produces a rich
mixture of radiances when rendered that are directly correlated
with the original image. Each pixel in a tree stand will
be represented by a mixture of leaf, trunk and soil for
instance, instead of a single value.
1.3 Potential Uses
ImageMapper provides the user with the ability
to generate Material Composition Maps for input to a variety
of applications.
- Visible, Radar, UV and Infrared Sensor Simulations
- Target Signature Analysis Codes
- Land Use / Land Cover Systems
- Operator Training, and
- Low observable design
1.4 Compatibility, Platforms
and Image Formats Supported
Operating Systems:
ImageMapper is written in Java and runs on
Windows 95/98/ME and XP/NT/2000. A version which operates
under UNIX/Linux operating
systems is also available.
Image Formats:
The following image formats
are supported on input:
- SGI RGB
- JPEG
- GIF
- TIF & GeoTIF (with some exceptions)
ImageMapper also imports nearly
any type of uncompressed image file format.
Output is in a simple non-proprietary format or convenient
standard formats such as SGI-RGB or 'tif' image formats
for import directly into a rendering engine. The material
map format is 'open' and freely distributable.
1.5 Unique Features
The user does not have to be a material classification
expert in order to set up and run ImageMapper.
The software provides the user with:
- Ease of Use
- Flexibility on input, supporting various image formats
- Flexibility on output (SGI RGB, TIF and native)
- An intuitive, easy to use interface for selecting
mappings
- Choice of classification algorithms
- Runs on a broad range of computing platforms (Java
based)
- Tools to perform simple image processing tasks
- Region definition tools that add a spatial dimension
to the classification
- Built-in infrared radiance and color simulation capabilities
for:
- Quality Assurance or
- as direct input to a sensor simulator
- Fast execution speeds :
- 25 seconds for a 512 by 512 image with 8 reference
mappings on a 700MHz AMD with 256Megs of memory
using SAM/MD classifier, 13 seconds using MD only
- 7 seconds to generate a 512 by 512 color image
- 7 seconds to generate a 512 by 512 radiance image
from 0.4 to 0.5 microns
|
|
|
2.0 Technical Description
|
ImageMapper is composed of two main functional areas:
the mapper/classifier and the simulator. The classifier uses reference
mappings provided by an analyst and through a choice of algorithms,
produces Material Composition Maps (MCMs). The simulator uses
the resulting MCMs to render color, radiance and reflectance maps
for map refinement and as input to real-time sensor simulators.
2.1 Image Mapping/Classification
Classifying imagery is a mix of science and art requiring
ingenuity and often a great deal of time and effort. Most classifications
take several iterations of mapping, rendering, evaluation and refinement
before a satisfactory result is obtained. Because the largest amount
of time and effort required in a classification is spent
in the iterative process of classifying, rendering and
evaluation, ImageMapper's
philosophy is to give the analyst a set of tools to
perform these tasks quickly and
efficiently.

Classification : In ImageMapper, classification
or the association of materials to
spectra in an image is done by the best image processing
system known to man, the human brain. The analyst defines a
set of
reference vectors, known as end-members, by associating
a sampling of spectra in the image with materials.
ImageMapper takes these
end-members and uses them to derive material composition on
a per-pixel basis for the remaining pixels in the image.
By using spectra directly from the image being classified,
environmental and optical system differences can to a large degree be ignored.
This assumes of course that the atmosphere is relatively
constant across the image and that the image itself is
not a mosaic of images taken under different environmental
conditions.
There are a large number of classification algorithms available for
spectral classification of imagery , supervised and unsupervised;
k-means, parallelipiped, mahalanobis, spectral angle,
maximum likelihood, iso-data, neural networks, and the
list goes on. No one algorithm is superior under all circumstances
and each has its inherent strengths and weaknesses. Attempts
to make associations between observed spectra in a pixel
and a reference set of materials automatically, without
human intervention, have for the most part failed. This
is due primarily to uncertainties in the environment at
the time of data acquisition and the limited amount of
reference spectra available for comparison. One of the
primary contributors to uncertainty in classification
is the environment at the time the imagery was taken;
atmospheric absorption (an overcast or clear day) can
have a profound effect on the spectral signature of a
material as seen by a sensor. Classifiers work by selecting
the material whose spectra or color most closely resembles
that in the pixel. If conditions such as haze change the
spectra, the results of the classification will suffer.
Classification Algorithms
ImageMapper makes available to the analyst three
algorithms for generating MCMs. Two of the simplest and
perhaps 'best' classification algorithms available; minimum
distance and spectral angle mapping, and a third, hybrid
algorithm, Angle/Distance that takes advantage of the
strengths of both and also overcomes some of their weaknesses.
Why were these algorithms chosen ? Because they are simple,
easy to understand, fast, and give a sharp analyst the
capability to better interpret and modify results. They
were also chosen because each has strengths in one of
the two main types of images analyst are likely to encounter,
high resolution images taken at close range and satellite
imagery of broad geographic backgrounds.
Minimum Distance classifiers (MD) measure the
distance in 'n'-space (n=3 for RGB) between the end-points
of reference vectors and the spectral vectors of the pixels
in the image. In cartographic applications, the classifier
looks for the reference material which it is closest to
the target pixel in 'n'-space and assigns it to that material.
In material mixturing, the three closests reference materials
are chosen and their relative proportions in the pixel
are weighted according to their distance. This algorithm
works surprisingly well under many circumstances, particularly
in cases where color and intensity are well defined and
associated with a single material.
The drawback of this method is that pixels with intensity
can overwhelm color and mislead the classifier into choosing
the wrong materials, i.e. it is difficult to distinguish
between bright objects if their colors are similar. This
can result in an unphysical mixtures of materials, which
might appear visually pleasing at first, but can have
serious effects in other portions of the electromagnetic
spectrum.Visually, it might not seem important that a
bright metallic surface got mixed in with bright concrete,
but when performing a radar simulation, it can be seriously
misleading.
Minimum distance works very well in instances where an
image has good color and intensity separation, or simply
good color separation, because similar intensities will
lie along separate axes.. An image of a building front
is a good example. Colors are separted in color space,
are normally associated with a single material, and the
minimum distance classifier works well.
Spectral Angle Mapping (SAM) measures the angle
(dot product) between reference spectra and the spectra
of the pixel in question. As with the minimum distance
classifier, cartographic applications finds the reference
vector with the smallest angle between it and the pixel
in questions and assigns that material to the pixel. In
material mixturing, the three closests reference materials
are picked and their relative proportions in the pixel
are weighted according to their angular separation. SAM
works well at identifying colors regardless of intensity,
which makes it an excellent choice for shadow removal.
This is both a strength and a weakness.
Using SAM, materials in shadow, whose vector points in
the same direction as their non-shadowed counterparts
will be accurately classified as the same material. This
can be a problem in something like a building front where
shades of yellow may be entirely different materials.
Something that a minimum distance classifier, which utilizes
intensity, could easily separate..
SAM works well on large geographic satellite imagery
where this algorithm can compensate for haze and shadows.
Color separations are also more subtle and SAM will be
more accurate than minimum distance algorithms at picking
out differences.
SAM/MD classification is a hybrid approach, using
the strengths of spectral angle mapping combined with
the strengths a of minimum distance classifier. It works
by first sorting the spectra by color and then uses intensity
to perform the final classification. This insures that
color matching is the primary criteria for end-member
selection, negating the shortcomings of a pure minimum
distance classification and then uses brightness information
into the classification to overcome SAM's inability to
differentiate on intensity.
SAM/MD's primary drawback is that it is more computationally
intensive either SAM or MD. SAM/MD requires three additional
MD calculations per pixel.At worst case, when only three
reference spectra are chosen, it can be twice as slow.
In cases of more than three spectra, the relative slow
down is not as significant.
For further information on the minimum distance and spectal
angle algorithms check the internet, There is a large
body of literature available devoted to classification,
including SAM and the minimum distance classifier.
|
|
2.2 Simulation:
ImageMapper's simulation capabilites are physics
based, fast and accurate. The software simulation engine
uses an MCM and has the ability to produce three different
types of images; color, integrated infrared radiance and
band averaged reflectance.
- Color: ImageMapper produces a color
image of the MCM using the tristimulus function. A color
image generated from an MCM can be a valuable source
of feedback for refining mappings. It provides the analyst
a means of comparing a derived image, based on their
mappings, with the original. Pixels in the simulated
image are assigned colors based on a set of measured
spectral databases and the material mixture map.
- Reflectance: Reflectance images represent the
average diffuse reflectance (and thus emissivity) of
pixels over a wavelength region ... a value which for
all intents and purposes does not change with lighting
conditions or time of day. This can be a useful input
to sensor simulators that do dynamic simulation. Instead
of calculating these values at rendering time, these
values can be stored as an 'alpha' plane in a texture
to modulate the intensity of a unity reflector or the
emittance of a unity emmiter, thereby removing some
of the computational burden from the simulator and giving
nothing up in terms of fidelity.
- Radiance: ImageMapper, when purchased
with the radiance engine, is capable of producing radiance
images in the visible through far Infrared regions of
the spectrum for any observer/target geometry and time-of-day.
The radiance engine incorporates the well validated
LOWTRAN radiative environment model. In the thermal
IR, the analyst supplies a temperature for each material
and region. The software calculates the blackbody radiance,
emissivity, path radiance and transmission to determine
the pixel radiance. In the near future, ImageMapper
will include a 3-node thermal model for terrain temperature
prediction and support facet normal or elevation maps
for solar illumination effects.
|
|
|
3.0 User's Guide
In practice, an ImageMapper session consist
of 6 steps:
- opening an image to map,
- assigning a set of reference materials to colors
by pointing and clicking on the image,
- processing the mappings to produce material composition
maps (MCMs),
- rendering an image from the classification to check
the quality of the classification,
- refinement of the classification based on comparison
between rendered and original images
- rendering the desired output images (if desired),
and
- saving the final results.
3.1 Main Window

There are three areas in the main window,
the material selection area (on the left), the central
display/classification area in the center, the Navigation/Region/Zoom
area (on the right).
The Material Selection area contains
the Material Library , Material
and Mappings panes. This area is used
for selecting materials from the material libraries
for mapping and for keeping track of reference mappings.
In the center Classification/Display work area
is the Classification/Display pane, a
'1X' display of the image or portion of the image to
be classified is displayed. This is the area in which
assignments are made. It is also the area where rendered
images are displayed.
Directly below the Classification/Display
pane is the Pixel Informer, a text-bar
reporting cursor location and value of a pixel, 'RGB'
or otherwise, depending on the type of image being
displayed.
On the right, in the Navigation/Region/Zoom area
are the Navigation pane, Region
Tools,
and Zoom pane.
The Navigation pane is used to navigate
through large images, changing the focus of the Classification
pane to be centered around where the analyst clicks
in the sampled version shown in the Nav
pane.
The Region Tools are used to define
and manipulate regions.
The Zoom pane provides a magnified
view of the area surrounding
the cursor in the classification
pane and can also be used
to define end-members.
Regions can be used to
partition and attribute pixels based on their spatial
features. Regions are a powerful tool, providing a spatial
element to a classification that can be used to;
- discriminate between spectrally confusing materials
- discriminate between urban and rural areas
- isolate homogeneous materials and remove noise
- provide a spatial level of thermal attribution which
is often needed when the substrate of a material has
a greater effect on its signature than the material
itself.
Creating, selecting and removing regions is simple
using the region tools.
|
| 3.2 Menus

There are seven menus on the menu bar: File,
Edit, Render, Utilites, View, Display and Help. Below
the menu items are shortcuts to
many of the often used functions.
The File Menu:

Open :
- Image
: Open an Image for Mapping.
TIF, GeoTIF, GIF, JPG, RGB and user-defined image formats are supported.
- Library: Open a material library
and add it to the list of materials available for mapping.
A list of additional libraries available from SOC are
located in the 'additional libraries' folder in the
ImageMapper directory. If you have purchased
the additional libraries from Surface Optics Corporation,
the libraries will be loaded upon selection.
- Mtf: Use a mapping developed
from another image on the current image. For images that
have been partitioned into more managable pieces for
a rendering engine, this is an extremely useful feature,
allowing the reuse of mappings developed for one portion
of an image to be automatically loaded for use on another
without having to re-enter the values.
Save Mappings: Saves
the current mappings to the
Map Text File.
Save Image: Saves
a copy of the image under a
different filename.
Close: Closes
the current classification session.
Recent Files: Lists
the last four image files processed
for quick access.
Exit: Exit
the software.
The
Edit Menu

Preferences Window: Sets display and processing
preferences.

- Mapping Delta refers to the delta
in counts around a reference mapping's color in color-distance
space that will be highlighted upon selection in the
classification window. The default is 10, meaning
any pixel within a color radius of 10 around the color
selected will be highlighted. In images with low contrast,
this value should be set to a lower number.
- True Color provides the option to
use either the reference material's true color in
overlaying pixels with the color associated with a
material OR using a false color, for example bright
yellow for water. False colors are sometimes easier
for visualizing mappings. The default is to use True
Colors. Note: False colors are assigned through the
material library file, if a false color is not available
(0,0,0), then true color is used in its place.
- Help Browser:
In the event that
the html browser is not
in the default location,
that location can be set
by pushing on the locate
browser button.
- Output Format:
ImageMapper can
output derived files
in one of two formats; SGI
RGB or Tiff. Select which
depending upon your application.
- MIDIS Hardware:
Selecting this button
allows the software to use
the MIDIS vector processor
to perform calculations.
If your computer is not
equipped with the MIDIS
processor, this selection
will be grayed out. For
more information on SOC's
MIDIS vector processing
engine see http://www.surfaceoptics.com.
Accept/Cancel: Accept or cancel the changes.
Header Window:

The header window
allows editing of parameters
that describe to the software the
format and size of the image
currently being displayed. It
also pops up in the event that
the image is not one of
the standard types and the format
is not recognized.
- Cols - The number
of columns or samples
in the image.
- Rows - The number
of rows in the image.
- Bands - The number
of bands in the image,
including and alpha
channels.
- File Offset - The
number of bytes in the
file header.
- Bands Offset - The
number of bytes before
a band of information.
- Line Offset - The
number of bytes per
line to offset.
- ByteOrder - Wintel
(little endian), IEEE
(big endian)
- DataType -
byte, short, integer
or float
- Interleave -
BSQ (Band Sequential),
BIL (Band interleave
by Line), BIP (Band
interleaved by pixel)
Accept/Cancel: Accept or cancel the changes.
Render Menu:

RGB : Create a color image from the classification.
There are no input parameters for creating a color
image. Colors already associated with the materials
mapped by the user are combined to produce the output
color image. The user does have a choice, through the
File/Preference menu, of using the true colors derived
from the material spectra or 'false' colors, which are
specified 'rgb' values found in the material library
text file.
Reflectance : Create a band averaged
reflectance image for a specific bandpass from the classification.
When a reflectance image is to be rendered certain
information must be supplied in order to perform the
calculation. For reflectivity, this is the spectral
band over which the reflectance calculations are made.
Reflectivities can be convolved with a Sensor Response
Function through a sensor response file selected using
the Sensor Response Function button. Rendering conditions
and thermal parameters are not an issue in reflectance
calculations. The resulting reflectance values in the
rendered image are band-averaged.

Radiance : Create a radiance image
Similar to creating a reflectance image, when a radiance
image is rendered certain information must be supplied
to the renderer to perform the simulation; the spectral
band over which the radiance calculations are to be
made, a description of the radiative environment and
temperatures for the materials and regions
in the image. Radiances can also be convolved with a
sensor response function and the radiative environment
changed to reflect conditions during the simulation.

Spatial : In
addition to spectral characteristics,
the spatial characteristics
of pixels surrounding a pixel,
its texture, can play a useful
role in the classification of an
image. One simple example of
this is separating a green car
and a green tree by examining
the uniformity of pixels in
the surrounding area. ImageMapper
provides three methods for quantifying
the spatial structure surrounding
a pixel and producing an image
layer from these measures
. 
They are Haar Wavelet
decomposition, Markov Random
Fields and Grey-level co-occurence
matrices. When these analyst
'renders' a spatial map, the
software will produce an image
of the same size as the original
image containing the spatial
measure for the algorithm
selected which can be used in classification.
Note:
At this time the inclusion of
spatial layers can produce artifacts
in the classified image. Examine
the results of any spatial/spectral
classification for errors.
Utilities Menu:
Through the Utilities Menu you can gain access to a number
of utilites for image processing
and manipulating data.

Clean MTF : Cleaning the MTF removes
all unused materials from the
MTF library.
Image Processing :
A set of simple image processing functions are available
to aid in the classification. These fuctions are primarily
for convenience and ease of use.

Reduce : For very large images, Reduce
creates a temporary image of reduced size for faster
panning and classification. Later, using the Open
Mapping menu item, apply the mapping developed
on the low-resolution version of an image to process
the higher resolution image.
Extract : Extracts portions of an image
from a larger image. Similar to reduce, only working
on a portion of an image results in faster panning and
classification. For very large images, mapping a small
area that is characteristic of the entire image, might
be sufficient. Later, using the Open Mapping menu
item, apply the mapping developed on the extracted version
of the image to process the entire image.
Statistics : Generate and view statistics
for the image being displayed.
Convert : Convert
images from one data type to
another, e.g. integer to byte.
Combine : Used to combine single band
images into RGB images for classification. Some remote
sensing data comes as a series of single band images.
Spectral Analyzer :
The spectral analyzer is a powerful tool for interrogating
spectral data to determine contrasts and features which
might help in target detection. With the Spectral Analyzer
it is possible to compare material reflectivities or
radiances spectrally. Make plots of reflectances, source
radiances and apparent radiances, take differences,
determine contrasts and make potential design decisions.

Atmospheric
Tool :
The atmospheric
tool provides a graphical user
interface to the Lowtran radiative
transfer code used
in ImageMapper to characterizes
the radiative environment for
rendering. The list of options
available in Lowtran are too
numerous to list here. For more
information on running Lowtran
and the meaning of the input
parameters see the Lowtran User's
Guide.

Batch
Processing :
Use batch processing
to process multiple files. The processing
will run as a background process,
however ImageMapper will
need to remain open in order
for the processing to complete.
However, during batch processing the
analyst can minimize the application.

- FILE - Opens
an analyst batch file
for processing.
- Add -
Adds a selected file
for batch processing.
- Remove -
Removes the selected
file from batch processing.
- Go - Starts
Batch Processing
- Cancel -
Cancels without processing.
- Rendering Options:
- Select which
output files will
be rendered (color,
reflectance, radiance)
- Processing Options:
- Overwrite
Existing Files -
If selected,
all current files
will be overwritten.
- Algorithm
- Select the
classification algorithm
which will be used
in processing. Applies
to all files.
- Radiance and
Reflectance Parameters
- Wavelength
- Set the beginning
and ending wavelengths
for the reflectance
and radiance calculations.
These values can
not exceed the bounds
of the current atmospheric
database.
- Gain and
Offset - If
you wish to scale
all your radiance
images to the same
Global Scaling;
1) Select the global
scaling box and
2) Set the values.
- Show Dialog -
Brings up a reporting
window that shows the
progress of the processing.
Once you have
selected 'Go' to start the processing,
the software will prompt you
for a default MTF filename.
All images which have not been
classified directly and do not
have their own MTF file, will
use the mapping information
in the default MTF filename
to perform the classification.
There are two important aspects
to remember when using the default
MTF file; 1) region definitions
are ignored and 2) the only
mappings that will apply are
those made for the 'base' region
in the default MTF file.
View Menu:
Through the view menu the analyst
can switch between the original
image and derived images; Color,
Reflectance, Radiance, Wavelet (both
decomposition and recomposition),
Markov, GLCM and the Material Composition
Map (MCM) to view the results of
the classification.
The Image Info menu item brings
up the Image Information window
which describes the characteristics
of the current image being display.

Shortcut buttons
are also available on the Main Panel
that correspond to the view menu
selections.

Image Info :
Provides a text description of the input image and
scaling factors for radiance images created.

Display Menu:
Through the display menu, the
analyst can select the bands of
the image that are being displayed.
The default assignments for color
images are 1=Red, 2=Blue and 3=Green.
You can also select a single band,
panchromatic display if desired.

Pressing on the
Select Bands menu item brings up
the Select Bands to Display dialog
box. Select the bands that are used
for the Red, Green and Blue channels
in the image or alternatively, display
a single band panchromatic image
by selecting the band to be displayed
in the Red/BW pull down and then
select Panchromatic.

Help Menu:

Opens this document. ImageMapper uses
a web browser for displaying documentation and its default
is set to look for Internet Explorer on a Windows 95/98/ME/XP machine. If the browser is not found, ImageMapper
will ask you to specify where the browser is on your
machine using the File/Preferences menu.
|
|
3.3 Window & Tools
The main window is divided into 4areas, left to right:
the Material Selection area, the main Classification/Display
area, and processing panes.
3.3.1 The Mapping Pane
The Material Selection area contains four elements;
the Mappings pane, Mapping Tools, the Material Library
pane and the Material pane.

Mappings Pane : shows existing material assignments.
A color, not a pixel, in the image is associated with
a material through a mapping. Each mappings contains
the three band value, in most cases RGB,
of the color assigned to a material and a description
of the material itself. For example, in the window above,
the entry:
R:031 G:028 B:021 Meadow Grass
means that pixels with an RGB triplet of 031:028:021
in the image are assigned to the material meadow
grass.
Each time a new mapping is performed, a new mapping
entry will be added to the list. In the example above,
three RGB values have been mapped to three different
materials. It is not necessary to have unique materials
for each mapping, however, colors must be unique. If
you map a second material to a color that has already
been mapped, a prompted will appear to ask whether or
not to replace the existing mapping with the new one.
If the answer is yes, the mapping will be replaced.
Mapping Tools:

Assign Mapping Button:
The assign mapping button
becomes active when the analyst
right-clicks in the image. This
freezes the display and fixes
the RGB value to the pixel the
cursor was currently on. The
analyst can then select the
appropriate material from the
materials pallete and by clicking
on this button, assign the selected
material to the RGB value.
Undo : Undoes last
mapping.
Highlight : Highlights
the current mapping in the image.
Pixels turn red in the image that have
the same RGB value and any pixels that are within the
Mapping Delta. It also sets the material
and material library windows to their appropriate values
and draws a small red box over
the location of the pixel that
served as the reference.
Trash/Delete : Removes
the selected mapping.
Clear : Clears all
mappings.
Material Library Pane:
The Material Library pane contains a listing of the
material libraries which are available to the analyst
for classification. At start-up, the libraries listed
in the LibraryList.txt file located in the ImageMapper
home directory are loaded. To add to this list, simply
edit the LibraryList.txt file.
To load additional libraries
while working on a classification,
go to the File menu and click on Open
Library. Library files have a
suffix of '.lib'.
TIP: Loading material libraries at start-up
is time consuming, so don't add libraries to the default
file unless you plan on using them in your classification.
Instead, just add them as necessary using the Open
Library command located in the File menu..
In addition to the default
libraries that are loaded when
ImageMapper initializes,
another library is loaded whenever
a new or existing image is loaded.
This library is called the MTF
library and contains all the
materials used in the classificaiton.
Clicking on any of the libraries in the Library pane
will display the list of materials associated with
that library.
These materials are then available for use in mapping.
Materials Pane:

The Materials Pane lists the materials contained
in the library highlighted in the Material Library
pane. It is in the Material pane that the analyst
selects the material which will be associated with a
pixel or color in the image. This can be done in one
of two ways: 1) By selecting a material first,
then assigning it to a color by clicking on the appropriate
pixel in the image Classification pane OR 2)
by using the middle button on
the mouse and clicking in the
image on the pixel of interest
and then selecting a material
and assigning it using the Mapping
Tools Assign button.
Using the first method, if the analyst wants to map the material
water to a body of water in the image, then
the Library containing the material water is first
selected. A list of the materials
in this library are then shown in the Materials
pane; including water. Clicking on water to set the
material, then a pixel in the water body in the image,
results in a mapping.
Using the second method.
A pixel in the water body is
selected first using the middle
mouse button, then the libarary
and material associated with
water are selected, followed
by pressing the Assign button
in the mappings tools.
Using either method, the mapping appears immeadiately in the Mappings
pane, and pixels with the same RGB value or within the
Mapping Delta of that value will change in color
to the color of water as shown on the material label
just above the Materials pane. This color can either
be set to the true color of the material itself or its
false color equivalent, depending on how the True
Color flag is set in the preferences menu.
|
|
3.3.2 The Classifier
Pane

The Classifier window is where mappings are performed. The Classifier
window contains
a 1X display of all or a portion of an
image.
If the entire
image can not be displayed in
the classifier window, the arrows
surrounding the window can be
used to move about the image.
The focus can also be changed
through the Navigation window.
Below the classification pane is a text field which shows the location
of the cursor in the image and the RGB, radiance or
reflectance value respective of what type of image
is being displayed.Reflectances
are in percentages and radiances are in units of watts/cm**2/steriadian.
Mouse Actions:
- Left - click results
in a mapping between
the pixel selected and
the current material.
- Center -
Freezes the color value
and allows selection
of material.
- Right - closes
a region when in region
definition mode.
- Shift-Left
- Freezes the zoom window
allowing classification
and region definition
to occur in the zoom
window
|
|
3.3.3 Navigation/Region/Zoom
Pane

The Navigation section contians four
tools:
- Navigation Window
- Region Tools
- Zoom Window
- Display Tools
The Navigation
Window displays a sampled version
of the entire image and allows navigation of very large images. By clicking
on a point in the navigation image or clicking and
dragging on the red box, the
center of the image displayed
in the classifier window is
changed.
Region Tools: Regions
give the analyst the flexibility to
derive a custom set of mappings
and temperatures for defined
areas on the image. Each region has its own sets of mappings and
attributes which are processed separately from other
regions.
For example, if a region is defined
around a car, the analyst can set the color
green to correspond with green paint in that region
and allow green in surrounding
areas to correspond with grass.
The temperature of the car can
also be different.

There are six tools in the region tool window:
- New - Press to begin defining a new region.
- Close - Press to close a region or right-click
in the classification window
- Cancel - Press to cancel the current region definition
- Region Select - Press to select an existing region
with the mouse or from
a list.
- Remove- Press to delete the selected region
- Undo - Press to undo the last point specified during
region definition
If Snap is used. Points on
the region will snap to the
closest edge that lies within
the tolerance value selected.
The Zoom Window :
The zoom window displays a zoomed
version of an area centered
around the cursor in the classification
window. In the zoom window,
both mapping and region definition
can be performed. To freeze
the zoom window, press Shift-Left
in the classification pane.
The zoom window will unfreeze
the next time the classification
window is entered.
Display Tools : The
display tools allow stretching
and brightness adjustments to
be made to the image being displayed.

Pressing on
the M (classification), Z (zoom)
or N (navigation) buttons results
in the image being stretched
across the image values displayed
in the corresponding window.
This can be helpful in instances
where the analyst wishes to
stretch the image displayed
out over a smaller dynamic range.
The R, G and B buttons and slider
allow the analyst to adjust
the brightness in the display
of any or all bands in the image.
3.3.4
The Display Toolbar

Display Select
: Shortcuts to the View menu.
These buttons allow quick toggling
between the original and derived
or rendered images.
Show Mappings : allows the user to toggle the
display between showing and not showing mappings and region graphics.
Blink : Toggles between the current image
and the last image displayed.
This can be useful for comparing the results
of a classification with the
original, or any other image. When
pressed, the last image is displayed, when released,
the current image is displayed.
Process: The process button forces
a new classification to be performed. This button
is red when new mappings or regions have been added,
it is green otherwise.
|
|
|
4.0 Output
ImageMappers output consists of several binary image files and one ascii file. The binary image files
are output in one of two formats, 'tif' or 'SGI-rgb' and
can be read into almost any image processing package. An additional
'hdr' file used by ImageMapper is produced everytime
a new file is loaded or produced. It contains information that
describes the image's
format to the software.
The ascii file, referred
to as the Map Text File (mtf), contains information about the classification
and is the key to interpreting the binary files.
It identifies
which materials correspond to which indices in the material
classification map (MCM) file, gives a list
of material and region attributes and contains the mappings themselves
along with the spectral reflectance of each
of the materials used.
|
4.1 Output Format
Binary Image File Format: With the
exception of the mtf file,
all other outputs from the ImageMapper
software are binary image files.
This includes rendered
images, such as Radiance '.rad', Reflectance '.rfl' and
Color '.clr' files and also the mcm file.
Multi-band image data is normally
stored in one of three ways;
Band-Interleaved-by-Pixel (BIP),
Band-Interleaved-by-Line (BIL)
or Band-Sequential (BSQ). Normally
there is also a fixed header
attached to the beginning of
the image which describes the
format and any other information
associated with the image.
ImageMapper outputs images
in one of three formats; Native,
SGI's RGB and Adobe Systems'
'tif' format. In general, the
native format is only used to
produce uncompressed versions
of compressed files and carries
the suffix, '.imp'. The rest
of the files are either in RGB
or tif formats. The choice of
which of the two formats is
used is left up to the analyst
and can be set through the preferences
menu.
Binary
Image File Formats:
- Native format
images consist of byte values
in a BIP format with a '0'
byte header (the image format
information is stored in
the '.hdr' files).
- RGB images are inverted relative to the way they
are viewed, the upper left corner of the image occupying
the lower left corner of
the data on the disk. Keeping the output in RGB
format allows rendered images to be used directly in rendering engines software. RGB image
files consist of a 512 byte header, followed by the image data
in a BSQ format. For a full
description of SGI's
RGB format visit SGI's website.
- TIF format files have an 8 byte header for a single
band image (radiance and reflectance) and 14 byte header
for color images. The TIF format document is available
from Adobe Systems via the world wide web.
Radiance and reflectance values,
which are inherently single-band
'float or real' numbers, are
scaled and stored in unsigned
byte images, each byte representing a scaled value.
The scaling for an image can be found using the Image
Info selection in the View menu.
Color images are three-band byte images with three bytes per pixel,
stored in either RGB or TIF format.
Material Classification
Maps (MCMs) are five, six
or seven-band images with five,
six or seven bytes per pixel,
also stored in either RGB or
TIF format. The first five bands
contain the materials; material1,
material2, material3, and the
weights or mixtures of the first
two materials within the
pixel, the third value being
1.0 - the sum of the other two.
The optional 6th and 7th bands
contain the alpha channel from
the original image (if one existed)
and the region map (if regions
were defined).
Mat1 Mat2 Mat3 %1 %2 Alpha Region ...... Mat1 Mat2 Mat3 %1
%2 Alpha Region
Materials are stored as indices which are associated
with their appearance in the map text file (.mtf). The
value '0' corresponds to the material listed first in
the map text file, 1 to the second material, and so
on.
The map text
file is the 'key' to the classification, do not remove
it or modify it unless you completely understand the
consequences of doing so. In some cases, modifying the
map text file can save time and allow manipulation of
the mapping without invoking the ImageMapper tool, but
use this option with caution.
Map Text File (.mtf) Format (ASCII):
Map
Text Files (.mtf) are self documenting, with parameter
names listed immeadiately after the value. An example
MTF file is shown below.
- Version 2.0
- C:\Documents and Settings\User\Desktop\Data\LAV120wheelDes.rgb
{Input Image}
- 256 256 3 {Columns,
Rows, Bands}
- 4 {Number of Libraries}
- MTF File {Library #0}
- .\\Natural_THR.lib {Library
#1}
- .\\ManMade_THR.lib {Library
#2}
- .\\Reference_THR.lib
{Library #3}
- 2 {Number of Regions}
- 'Base' {Region Name}
- 0.0 {Temperature}
- 4 {Number Of Vertices}
- -1 -1 {Vertex #0}
- 258 -1 {Vertex #1}
- 258 258 {Vertex #2}
- -1 258 {Vertex #3}
- 3 {Number of Mappings
in Region}
- 169 {Band 1}
- 154 {Band 2}
- 115 {Band 3}
- 0 0 0 0 {Library, Material,
X, Y}
- 12 {Band 1}
- 11 {Band 2}
- 9 {Band 3}
- 0 1 0 0 {Library, Material,
X, Y}
- 33 {Band 1}
- 30 {Band 2}
- 22 {Band 3}
- 0 2 0 0 {Library, Material,
X, Y}
- 'lugnut' {Region Name}
- 395.0 {Temperature}
- 5 {Number Of Vertices}
- 134 192 {Vertex #0}
- 168 164 {Vertex #1}
- 140 128 {Vertex #2}
- 106 132 {Vertex #3}
- 91 156 {Vertex #4}
- 3 {Number of Mappings
in Region}
- 169 {Band 1}
- 154 {Band 2}
- 115 {Band 3}
- 0 0 0 0 {Library, Material,
X, Y}
- 12 {Band 1}
- 11 {Band 2}
- 9 {Band 3}
- 0 1 0 0 {Library, Material,
X, Y}
- 33 {Band 1}
- 30 {Band 2}
- 22 {Band 3}
- 0 2 0 0 {Library, Material,
X, Y}
- 3 {Materials}
- ' Construction Asphalt'
{Material Name}
- 0 0 {Lib, Mat}
- 300.0 {Temperature}
- 491 {Number of reflectance
values}
- 0.42 4.0837
- 0.422 4.6136
- 0.424 4.7327
- 0.426 4.8886
- 0.428 4.8321
- .
- .
|
|
4.2 Input File Formats
4.2.1 Material Properties File Format (ASCII)
Material Properties files contain spectral information
and other quantities that characterize the material
for sensor simulation.
Lines 1->6 : Comment Lines (to be used at a later
date)
Line 7: Number of Spectral Reflectance Points (numberOfPoints)
Lines 8 -> (7+numberOfPoints) : Wavelength (in
microns), Reflectance <CR>
4.2.2 Material Library File Format (ASCII)
Material Library Files are basically lists of the
materials in a particular library. ImageMapper reads
these files and loads the material properties files
in the material library file into the tool.
Line 1 : Library Name
Line 2: Number of libraries (numberOfLibraries)
Line 3 -> (2+numberOfLibraries) : fileType, 'Material
Proporties Filename', R, G, B
** R, G, B int values between 0 and 255 which are
the 'false' colors for the material **
4.2.3 Preferences File (Pref.txt) Contains
a number of preferences set by the user that are loaded
at startup into ImageMapper.
Line 1: Number of Libraries to load upon initialization
Lines 2 -> (1+intiLibraries) : 'Library Filenames'
Next Line : Mapping Delta
Next Line: Location of browser
Next Line: Coloring Scheme to Use (0=falseColor,
1=trueColor)
Next Line: Location of last file processed
|
|
|
5.0 Tutorial
Step 1: Opening an image.
Go to File/Open menu and select an image using the image
browser.
There are a number of sample images located in the Tutorial
directory under the ImageMapper installation directory. For
this tutorial, select the speedway image by double clicking
on it. There will be a pause as the image is loading, then the
image should appear in the main window.

'cg2_lasvegas-speedway512.rgb' is a texture of a fictitious
speedway which was produced using a paint or drawing tool. Notice
how the colors are very well defined. This image represents a simple texture, very
well defined colors representing different materials in the
image, the asphalt is gray, the grass is a mixture of green
and black, there is a blue and red painted border.
Step 2: Defining reference mappings.
To define a reference mapping you
must assign a
material to a pixel/color in the image.
ImageMapper comes with three materials libraries loaded, natural,
man-made and reference. The process of reference mapping is to select a materials
from these libraries and assign them to the correct pixels in
the image.
Selecting a Material :
A material is selected when it is highlighted in the materials
window. When ImageMapper starts up, you should see the following
in the ImageMapper Library and Material panes. The highlighted
values indicate that the Construction Asphalt material in the
Natural library has been selected. Just above the Materails
pane you are shown the color and RG&B values of the selected
material.

Click on the material 'Brown Dry Gravel'
in the materials panes.
The materials pane should change to look like
this where the color of gravel and its RGB values are displayed:
There isn't any Brown Dry Gravel in the speedway
image, select something that is.
Click on the material 'Construction Concrete'
in the materials panes.
Doing so, we get a material with a color much more closely
matching what we see in the image and also is consistent with
what we would expect to find on a speedway.

Change libraries by double clicking on the ManMade library
in the material library window highlighting it as shown below,
and then select Oxidized Galvanized Steel Metal.

Clicking on the ManMade Library changed the material window
to reflect the materials in the ManMade Library. The gray of
the Oxidized Steel is close in color to the Concrete, however,
it is obviously a poor choice for use in this image. If this
were a texture of a tin metal roof however, this material would
probably be the best choice.
Here we have encountered one of the principal dilemas in
spectral based material classification which is faced routinely
by analyst, color confusion between materials. The question
is, which material best matches the characteristics of the items
presented in the image. Where color confusion exists, the choice
of materials relys solely upon the analyst knowledge of what
is in the image, their spatial perceptions, and a host of other
factors which is why a human-in-the-loop is almost always necessary
when classifying imagery. The choice of materials can also depend
on what the classification will be used for.
For the purposes of generating color images, the choice
would not matter, because gray is gray is gray. But when the
material classification is intended to be used in the thermal
infrared or radar regions of the spectrum, the results of using
a metal versus asphalt can have a profound effect on its signature.
The best choice of course, is the material that accurately
describes what is in the image. If the analyst plans on using
the data for infrared or radar simulation and knows that the
grays are asphalt, then assigning grays in the image to asphalt
in spite of a slight mismatch in color is the correct thing
to do.
All that being said, lets assign the gray to concrete.
Select the Natural library by double clicking on Natural
in the library window, and then click on concrete. Your mapping
windows should again look like this:

Move the cursor over the image looking for pixels with
a color similar to concrete (153,150,137). Just below the display
pane you will see a set of values reporting the location and
RGB value of the pixel the cursor is currently on. In this case,
pixel 50,453 has an RGB value of 143:143:143.

Locate pixel 50,453 in the image (part of
the road) and click on it.
You have just completed your first mapping !!!
Congratulations !!!
ImageMapper now takes every pixel with that same value or
within the mapping delta limit and turns it the color of the
material as shown in the material label.

It also lists your new mapping in the Mappings widow.
If the color of the material is closely matched to the
pixel, you may see little or
no difference in the appearance of the image. This is a good
thing. In the image above, concrete was assigned to the light
gray material while its own color was slightly redder so it
is fairly apparent. When the two colors are
so closely matched that its difficult to see
the difference, you can highlight the assignment
by pressing on the yellow highlighting tool
just below the mapping. Doing so will cause everything
classified as concrete to turn red.
Click on the Construction Concrete mapping in the mappings
window. Then click on the highlight button.

Everything classified as concrete will turn red.
Continue making associations between colors and materials.
You will probably notice that all the materials you see
in the image are not present in the material libraries. For
the libraries supplied with ImageMapper, this is more than likely
to be the case. For example, blue painted concrete. There is
no blue painted concrete material in the libraries.
For now, pick a material which most closely resembles the
material itself. Unpainted concrete is probably the best choice
for sensor simulation because in the IR, the thermal characteristics
will be close to the same even though the solar albedo might
be slightly different as will the emmisivity. If you were doing
strictly visible simulation, you might want to choose anything
close to blue.
Shown below is an example of a classification meant for
use in infrared simulation which uses the additional material
libraries available from Surface Optics. In particular, the
paint library was used for the red, blue and
yellow materials.

Not a bad mapping. If you are using ImageMapper's
stock library of materials, your mapping will not
be as good because there are no blue and yellow
materials. But how good is the mapping? To check, we
produce a simulated color image using the classification and compare
it with the original. Go on to step 3 and 4 to find out how.
Step 3: Processing the mapping to get material
mixture maps and generating a color image.
Now that the mappings are completed its time to
process the image into a material mixture map. This can be done
one of two ways. The first is by pressing the red Process button
in the toolbar. A blue
progress line will appear just below the Classification/Display
window denoting the progress of the classification. When it is
done, the line will disappear, the processing will be completed
and the process button will turn green. A second method is to
select the one of the rendering choices from the rendering menu, this will result
in two things; 1) the image will be processed and 2) a
rendered image will be created from the processed
image.

Select Render/RGB from the Render menu.
The 'Updated Mappings' window will appear because
new mappings were made. Click 'Yes' to overwrite the previous
classification file. You might want to backup the
previous classification before proceeding. If so,
press no and go
to the File/Save MTF File menu item and save the
'mtf' file under a different name. Then you can
always replace the current one with the saved version
if you wish to go back.

The software will ask if you wish
to overwrite the previous classification file (mcm)
if one exists.

Next, the Classifier input window will appear. Choose a processing method, SAM/MD for this classification
and press 'OK'.

Through the Classifier Input window
you can control the algorithm used, which bands
of the input image are used in the classification,
and if a spatial layer exists, include it as well.
Once you have pressed OK, the Classifier Dialog
Box will be replaced with a processing bar showing the progress of the classification.
When the bar turns completely blue the classification
will finished.

Upon completion of the classification, a second
progress bar will appear in the Display window showing the progress
of the color image generation. When this is complete, the color
image will automatically be loaded into the display pane for examination.
Below is the color image image generated from our classification.
If you wish to use SOC's classification, use
the 'File/Open Mapping' menu. ImageMapper allows the use of mappings
from other sessions or any other image to be used on any image.
This facilitates the use of image mappings across large, subdivided
images. Select the 'cg2_lasvegas-speedway512.rgb.mtf ' file.
Note: If you did not purchase the additional
material libraries, the SOC mapping will not load as the material
libraries it is looking for are not present.

Rendered & | |