Sunteți pe pagina 1din 110

DARTCOM

iDAP/MACROPRO
INTEGRATED DISPLAY AND PROCESSING SOFTWARE
FOR SATELLITE IMAGERY AND METEOROLOGICAL
DATA WITH AUTOMATIC MACRO PROCESSOR

k' '•• \\y)


\6--

\;

- V -

JL . • I•'••

' i•:•
Vcd

S0FTWARE
USER GUIDE
Dartcom
iDAP/MacroPro
Integrated display and processing software for
satellite imagery and meteorological data
with automatic macro processor
Software user guide

Fourteenth edition (May 2011)


Copyright © 1997-2011 Dartcom and its licensors
QuickTime
"QuickTime"and the QuickTime logo are trademarks used under licence.
The QuickTime logo is registered in the US and other countries.
This software is based in part on the work of the Independent JPEG Group.
Includes PaintLib version 2.6.2, copyright © 1996-2005 Ulrich von Zadow and other
contributors.
Includes LibPNG version 1.2.13, copyright © 1998-2006 Glenn Randers-Pehrson, 1996-1997
Andreas Dilger, 1995-1996 Guy Eric Schalnat, Group 42, Inc.
Includes ZLib version 1.2.3, copyright © 1995-2005 Jean-loup GaiIIy and Mark Adler.
Includes LIbTIFF version 3.8.1, copyright © 1988-1997 Sam Leffler, 1991-1997 Silicon
Graphics, Inc.
Includes LibUnGIF version 4.1.0.
Includes LibGeoTIFF, copyright © 1995 Niles D Ritter.
Includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit
(http://www.openssl.org/).
Includes a version of the GCTP library.

Dartcom, Powdermills, Postbridge,Yelverton, Devon,


PL206SP,UK
L Telephone (01822) 880253 • International +44 1822 880253
DARTCOM Fax (01822) 880232 • International +44 1822 880232
support@dartcom.co.uk http://www.dartcom.co.uk
CONTENTS
?a*4 *•
Contents

1 Overview
Introduction to iDAP .1-1
Introduction to MacroPro..................................................................................................1-2
Directorystructure............................................................................................................1-2

2 Using the software


Introduction......................................................................................................................2-1
Documentwindows...........................................................................................................2-1
Image document windows...........................................................................................2-1
Textarea..................................................................................................................2-2
Imagearea...............................................................................................................2-2
Fax document windows ...............................................................................................2-2
Animation document windows....................................................................................2-3
Animationarea.......................................................................................................2-3
Animationcontrols.................................................................................................2-3
Theapplication window....................................................................................................2-5
Menubar ...................................................................................................................... 2-5
Toolbar........................................................................................................................2-5
Documentarea.............................................................................................................2-7
Read-outs panel ...........................................................................................................2-7
Statusbar .....................................................................................................................2-9
Automatic document updating .........................................................................................2-9
Automaticprocessing......................................................................................................2-10

3 Software menu reference


Introduction......................................................................................................................3-1
Conventions used in this section..................................................................................3-1
File menu ..........................................................................................................................3-3
Open... ........................................................................................................................ 3-3
Create from raw sub-menu ........................................................................................3-3
HRPT... .................................................................................................................. 3-3
Planes area........................................................................................................3-5
8 -bit reduction area.........................................................................................3-5
Sub-sample area...............................................................................................3-5
Sizearea............................................................................................................3-5
Optionsarea .....................................................................................................3-5
Viewarea........................................................................................................... 3-6
Creating the sub-sampled image.......................................................................3-6
Saving the sub-sampled image..........................................................................3-6
CHRPT... ............................................................................................................... 3-6
SeaWiFS. . . ............................................................................................................. 3-6
AHRPT... ............................................................................................................... 3-6
DMSP... ................................................................................................................. 3-6
GVAR... .................................................................................................................. 3-7
Sub-sample level area......................................................................................3-7
Area area...........................................................................................................3-7
Channels area...................................................................................................3-7
iv j CONTENTS

Options area .....................................................................................................3-8


Cursorposition area........................................................................................3-8
Viewarea...........................................................................................................3-8
Creating the sub-sample....................................................................................3-8
Saving the sub-sample ......................................................................................3-8
Close.............................................................................................................................3-8
Save..............................................................................................................................3-9
Saveas.. ....................................................................................................................... 3-9
Saveall modified..........................................................................................................3-9
Delete... ....................................................................................................................... 3-9
Import sub-menu......................................................................................................3-10
HRPT/CHRPT Grabber raw ... ............................................................................. 3-10
Dundee standard raw ... ....................................................................................... 3-li
Export sub-menu......................................................................................................3-11
Image... ................................................................................................................ 3-11
Area area.........................................................................................................3-12
Options area ...................................................................................................3-12
Format area....................................................................................................3-12
Exportingthe image........................................................................................3-13
Data... .................................................................................................................. 3-13
Area area.........................................................................................................3-13
Dataarea ......................................................................................................... 3-14
Formatarea....................................................................................................3-14
Filename area................................................................................................3-15
Exportingthe data...........................................................................................3-15
HRPTsub-menu...................................................................................................3-15
PCIGeomatica... ............................................................................................ 3-15
Exportsettings area.................................................................................3-16
Mapoption area........................................................................................3-16
Exportingthe image...................................................................................3-17
ERDASIMAGINE .. ......................................................................................... 3-18
ENVI/IDL... .................................................................................................... 3-19
GeoTIFF... ...................................................................................................... 3-21
NOAAlevel lB... ............................................................................................. 3-22
Output area................................................................................................3-22
Exportingthe data.....................................................................................3-23
Otherraw format ... ........................................................................................ 3-23
Output area................................................................................................3-23
Exportingthe data.....................................................................................3-24
Ancillarydata .. ............................................................................................... 3-24
Output area................................................................................................3-25
Exportingthe data.....................................................................................3-25
CHRPTsub-menu.................................................................................................3-25
PCIGeomatica... ............................................................................................ 3-25
ERDASIMAGINE .. ......................................................................................... 3-25
ENVI/IDL... .................................................................................................... 3-25
GeoTIFF... ....................................................................................................... 3-25
Otherraw format ... ........................................................................................ 3-25
Ancillarydata .. ............................................................................................... 3-26
SeaWiFSsub-menu............................................................................................... 3-26
PCIGeomatica... ............................................................................................ 3-26
CONTENTS I V

ERDAS IMAGINE .. ......................................................................................... 3-26


ENVI!IDL... .................................................................................................... 3-26
GeoTIFF... ...................................................................................................... 3-26
SeaWiFSlevel 0... ........................................................................................... 3-26
Output area................................................................................................3-27
Exportingthe data .....................................................................................3-27
Ancillarydata .. ............................................................................................... 3-27
AHRPTsub-menu ................................................................................................3-27
PCIGeomatica... ............................................................................................ 3-27
ERDASIMAGINE .. ......................................................................................... 3-27
ENVI/IDL... .................................................................................................... 3-27
GeoTIFF... ...................................................................................................... 3-27
DMSPsub-menu...................................................................................................3-28
PCIGeomatica... ............................................................................................ 3-28
ERDAS IMAGINE .. ......................................................................................... 3-28
ENVI/IDL... .................................................................................................... 3-28
GeoTIFF... ...................................................................................................... 3-28
MSG LRIT/HRIT sub-menu.................................................................................3-28
PCIGeomatica... ............................................................................................ 3-28
Export settings area.................................................................................3-29
Mapoption area........................................................................................3-30
Exportingthe image...................................................................................3-30
ERDASIMAGINE .. ......................................................................................... 3-30
ENVI/IDL... .................................................................................................... 3-30
GeoTIFF... ...................................................................................................... 3-31
GOESLRIT sub-menu ..........................................................................................3-31
PCIGeomatica... ............................................................................................ 3-31
ERDAS IMAGINE .. ......................................................................................... 3-31
ENVI/IDL... .................................................................................................... 3-31
GeoTIFF... ...................................................................................................... 3-31
MTSAT LRIT/HRIT sub-menu.............................................................................3-31
PCIGeomatica... ............................................................................................ 3-31
ERDAS IMAGINE .. ......................................................................................... 3-31
ENVI/IDL... .................................................................................................... 3-32
GeoTIFF... ...................................................................................................... 3-32
Print... ....................................................................................................................... 3-32
Area area ..............................................................................................................3-32
Options area.........................................................................................................3-32
Printingthe image................................................................................................3-33
Printsetup ... ............................................................................................................. 3-33
Exit.............................................................................................................................3-34
Edit menu........................................................................................................................3-35
Undo...........................................................................................................................3-35
Redo...........................................................................................................................3-35
Cut..............................................................................................................................3-35
Copy...........................................................................................................................3-35
Paste...........................................................................................................................3-35
View menu ......................................................................................................................3-36
Panand scroll mode...................................................................................................3-36
Magnificationmode...................................................................................................3-36
Setmagnification ... ................................................................................................... 3-36
Vj CONTENTS
-r . - - --- -a -'r - - - -•---a - ........ -

Palettekey ... .............................................................................................................. 3-36


Stationposition..........................................................................................................3-37
Referencepoints.........................................................................................................3-37
Overlays...................................................................................................................... 3-37
Lat/lon legends...........................................................................................................3-37
Toolbar.......................................................................................................................3-37
Read-outs panel.........................................................................................................3-37
Acquisitionstatus panel.............................................................................................3-38
Statusbar ............................................................................................ ........................ 3-38
Restore from original data .........................................................................................3-38
Processing menu............................................................................................................3-39
Enhance... ................................................................................................................. 3-39
Plane area.............................................................................................................3-40
Enhancement profile area..................................................................................3-40
Preset area............................................................................................................3-40
Formulapalette .. ....................................................................................................... 3-41
Settings area ........................................................................................................3-41
Palette area...........................................................................................................3-43
Colours area.........................................................................................................3-43
Applying the formula palette to the image...........................................................3-44
Editcalibration ... ...................................................................................................... 3-44
Manualcalibration ... ................................................................................................ 3-45
Temperature adjustment ... ....................................................................................... 3-45
Sharpen.. ................................................................................................................... 3-45
Soften... ..................................................................................................................... 3-45
Extractedges ... ......................................................................................................... 3-46
Blur.............................................................................................................................3-46
Rotate sub-menu.......................................................................................................3-46
90° ......................................................................................................................... 3-46
180° ....................................................................................................................... 3-46
Flipsub-menu ...........................................................................................................3-46
Horizontal.............................................................................................................3-46
Vertical..................................................................................................................3-46
Navigationmenu............................................................................................................3-47
Navigate......................................................................................................................3-47
Swatheangle ... .......................................................................................................... 3-47
Nudgeoverlay mode...................................................................................................3-47
Distance, bearing and profile mode...........................................................................3-47
Displayarea..........................................................................................................3-48
Read-outs area.....................................................................................................3-48
Projection transform ... ............................................................................................. 3-49
Mapoption area...................................................................................................3-49
Baseimage area...................................................................................................3-49
Image processing area........................................................................................3-49
Generating the projected image............................................................................3-50
BlueMarble masking ... ............................................................................................. 3-50
Image processing area........................................................................................3-50
Source area...........................................................................................................3-51
Applying the Blue Marble mask............................................................................3-51
DEMmasking ... ........................................................................................................ 3-51
Land mask area ...................................................................................................3-51
CONTENTS VII

Sea mask area......................................................................................................3-52


Image processing area ......................................................................................... 3-52
Source area...........................................................................................................3-52
Create matrix file area.........................................................................................3-52
Applyingthe DEM mask.......................................................................................3-52
Overlaysettings . . . ..................................................................................................... 3-53
Mapoptions ... ........................................................................................................... 3-54
Mapping area.......................................................................................................3-54
Image area............................................................................................................3-55
Overlays.., button................................................................................................3-55
Referencepoints . . . .................................................................................................... 3-55
Overlaysutility ... ....................................................................................................... 3-56
Import overlay from text file area......................................................................3-56
Export overlay to text file area...........................................................................3-56
Utilitiesmenu.................................................................................................................3-57
Configuration.. .......................................................................................................... 3-57
Station tab............................................................................................................3-57
Paths tab...............................................................................................................3-58
Session tab...........................................................................................................3-59
Setupassistant ... ....................................................................................................... 3-59
Security... .................................................................................................................. 3-60
Lockingthe software ............................................................................................. 3-60
Unlockingthe software ......................................................................................... 3-60
Automaticupdate.......................................................................................................3-60
StartMacroPro.. ........................................................................................................ 3-61
Start MacroPro automatically....................................................................................3-61
Automatic processing.................................................................................................3-61
Automatic processing settings ... ............................................................................... 3-61
Choosing, saving and deleting macro sets............................................................3-61
Creating, deleting and sorting macros..................................................................3-62
Editinga macro.....................................................................................................3-62
Enhance settings..................................................................................................3-63
BlueMarble settings............................................................................................3-64
DEM settings........................................................................................................3-64
Exportimage settings.........................................................................................3-65
Exportdata settings............................................................................................3-66
Printsettings........................................................................................................3-66
Save settings.........................................................................................................3-67
Archivesettings ...................................................................................................3-67
Animatesettings..................................................................................................3-67
Reproject settings................................................................................................3-68
Create palette settings.........................................................................................3-69
Testinga macro.....................................................................................................3-69
Window menu ................................................................................................................3-70
Cascade.......................................................................................................................3-70
Tilehorizontally.........................................................................................................3-70
Tilevertically..............................................................................................................3-70
Arrangeicons.............................................................................................................3-70
Help menu.......................................................................................................................3-71
Helptopics..................................................................................................................3-71
About... ..................................................................................................................... 3-71
' viii CONTENTS

4erciice.*

A Creating mask files


Introduction...................................................................................................................... A-i
How to create mask files .................................................................................................... A-i

B Formula programming
Introduction...................................................................................................................... B-i
Languagesyntax ...............................................................................................................B-i
Formula components ................................................................................................... B-i
Statements...................................................................................................................B-i
Comments....................................................................................................................B-2
Expressions..................................................................................................................B-2
Literals.........................................................................................................................B-2
Constants.....................................................................................................................B-2
Variables......................................................................................................................B-3
Operators.....................................................................................................................B-4
Functions.....................................................................................................................B-4
Functionreference ............................................................................................................B-5
Generalfunctions ........................................................................................................B-5
Trigonometric functions..............................................................................................B-5
Trigonometric conversion functions............................................................................B-6
Powerfunctions...........................................................................................................B-6
Imagefunctions...........................................................................................................B-6
Temperature conversion functions..............................................................................B-7

FIGURES ix

Figures
1.1 The role of the Dartcom iDAP software in Dartcom systems .. ......... . ..................... 1-1
1.2 An example of the directory structure used by iDAP and MacroPro.....................1-2
2.1 An example of an image document window..........................................................2-2
2.2 An example of a fax document window.................................................................2-3
2.3 An example of an animation document window...................................................2-3
2.4 The pop-up animation tools window.....................................................................2-4
2.5 An example of the MAP application window.........................................................2-5
2.6 The read-outs panel................................................................................................2-8
3.1 The Open window .................................................................................................. 3-3
3.2 The HRPT sub-sampler window..........................................................................3-4
3.3 The HRPT data path window................................................................................3-4
3.4 The GYAR sub-sampler window...........................................................................3-7
3.5 The Save as window ............................................................................................... 3-9
3.6 The Delete window ................................................................................................3-9
3.7 The HRPT/CHRPT Grabber raw importer window.........................................3-10
3.8 The Image export options window....................................................................3-12
3.9 The Data export window.....................................................................................3-13
3.10 The Data export area window.............................................................................3-14
3.11 The HRPT PCI Geomatica exporter window....................................................3-15
3.12 The HRPT NOAA level 1 B exporter window.....................................................3-22
3.13 The HRPT raw exporter window........................................................................3-23
3.14 The HRPT ancillary data exporter window......................................................3-24
3.15 The SeaWiFS level 0 exporter window...............................................................3-26
3.16 The MSG LRIT/HRIT PCI Geomatica exporter window..................................3-29
3.17 The Print options window ..................................................................................3-32
3.18 The Print window ................................................................................................3-33
3.19 The Print Setup window ...................................................................................... 3-33
3.20 The Set magnification window...........................................................................3-36
3.21 The Key window ................................................................................................... 3-37
3.22 The Enhance window..........................................................................................3-39
3.23 The Formula palette window..............................................................................3-41
3.24 The Formula palette window configured for a classification product................3-42
3.25 The Calibration editor window..........................................................................3-44
3.26 The Temperature adjustment window...............................................................3-45
3.27 The Sharpen window...........................................................................................3-45
3.28 The Soften window..............................................................................................3-46
3.29 The Extract edges window..................................................................................3-46
3.30 The Swathe angle window...................................................................................3-47
3.31 The Distance, bearing and profile window .......................................................3-48
3.32 The Projection transform window.....................................................................3-49
3.33 The Blue Marble masking window ....................................................................3-50
3.34 The DEM masking window.................................................................................3-51
3.35 The Overlay settings window..............................................................................3-53
3.36 The Map options manager window ...................................................................3-54
3.37 The Reference points window.............................................................................3-55
3.38 The Dartcom Overlays Utility program.............................................................3-56
3.39 The Configuration window.................................................................................3-57
3.40 The Configuration window with the Paths tab displayed ..................................3-58

RM
X FIGURES
.s- - --- -

3.41 The Configuration window with the Session tab displayed...............................3-59



3.42 The Setup assistant window...............................................................................3-59

3.43 The Lock iDAP window.......................................................................................3-60

3.44 The Automatic processing window....................................................................3-61

3.45 The automatic enhancement settings...................................................................3-63

3.46 The automatic Blue Marble masking settings ......................................................3-64

3.47 The automatic DEM masking settings..................................................................3-64

3.48 The automatic image export settings ...................................................................3-65

3.49 The automatic data export settings......................................................................3-66

3.50 The automatic print settings.................................................................................3-66

3.51 The automatic save settings.................................................................................. 3-67

3.52 The automatic archiving settings .......................................................................... 3-67

3.53 The automatic animation settings ......................................................................... 3-67

3.54 The automatic reprojection settings ......................................... . ............................ 3-68

3.55 The automatic palette creation settings................................................................3-69
TABLES xi

Tables

3.1 Supported HRPT raw data formats ......................................................................3-23

3.1 Supported CHRPT raw data formats....................................................................3-25

3.3 Types of enhancement profile, their shapes and their effects on images .............3-40

3.4 Automatic processing operations .........................................................................3-63

B. 1 Reserved formula constants...................................................................................B-3
xii DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
- .-- . -sr -- - .a-.- - ------ - --
1-1

S EChO N

Overview

Introduction to MAP
The Dartcom 1DAP (integrated display and processing) software allows images, anima-
tions and meteorological data from all Dartcom image and data acquisition systems to be
displayed and processed in one piece of software. This removes the need for a separate
ingest and display application for each data acquisition system, and allows easy expansion
of Dartcom systems.
iDAP provides functions for opening, viewing, manipulating, processing, saving, printing
and exporting satellite images, animations and meteorological data (such as faxes).
Multiple images, animations and faxes can be viewed simultaneously. A wide range of
manipulation and processing facilities are available, including magnification and reduc-
tion, enhancement, creation of products and overlaying of maps and grids.
iDAP uses Apple's QuickTime TM technology to provide smooth, high-quality animations
with facilities such as selective playback, frame removal and undo/redo.

Figure 1.1 Low resolution Digital polar-orbiter data


The role of the Dartcom polar-orbiter (HRPT, CI-IRPT, SeaWiFS,
data (APT) AHRPT and DMSP)
DAP software in
Dartcom systems

Dartcom MAP


Digital GOES Variable

geostationary data format data
(LRIT and HRIT) (GVAR)
DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE
S.rwr,Th* n rfl -r - •- es- t.'-'- 4'n - -•_-<,

Introduction to MacroPro
The Dartcom MacroPro software provides powerful yet easy-to-use automatic processing
facilities for iDAP image documents. It allows macros to be created which perform auto-
matic enhancement, navigation, Blue Marble and DEM masking, exporting, printing,
saving, archiving, animation, reprojection and formula palette creation whenever a docu-
ment is updated with new data (by an acquisition system for instance).
iDAP can then be set up to automatically update the processed documents if they are
open, therefore providing a completely automatic acquisition, processing and display
system when used with Dartcom acquisition systems.

MacroPro allows iDAP image and animation documents to be opened purely


"1 for the purposes of checking them before or after automatic processing. It
0
does not allow documents to be saved or processed manually. -

Directory structure .. .,..


An example of the directory structure used by MAP and MacroPro is shown in figure 1.2.
In the example, iDAP and MacroPro are installed in the Program Files folder on the C:
drive, but they can be installed on any drive and in any folder on the computer.

Figure 1.2
An example of the Program Files
directory structure used
by IDAP and MacroPro Dartcom
jiiDAP
DAP and MacroPro applications and support files
Auto processing macro sets
Automatic processing macro presets for MacroPro
Enhancement presets
Enhancement presets for 1DAP and MacroPro
Formula palette presets
Formulae and palette presets for formula palette
creation in DAP and MacroPro
Map options
Projection transformation presets for image
• reprojection IDAP and MacroPro
Reference points
Reference point database presets for iDAP and
MacroPro
L Map overlays
Map overlay vector files at various resolutions
Blue Marble
NASA Blue Marble data files in GRD98 format
DEM
DEM (digital elevation model) files in GRD98 format
Dartcom

I Images
Images and animations produced by Dartcom acquisition systems

J Sample images
Sample 1DAP image, animation and fax documents
2-1

SECTION

2
Using the softwa e

Introduction
1DAP and MacroPro are designed to provide a wide range of professional features without
compromising ease-of-use and accessibility by sharing many of their basic features with
other Windows applications. They use a multiple document interface (MDI) to allow
many document windows to be open simultaneously. Documents may be opened, saved
and printed and windows moved, resized and arranged. An on-line, context-sensitive
help system and "tool tips" help you to become familiar with the software quickly.
This section assumes a moderate level of familiarity with these standard Windows fea-
tures. If you have not encountered them before, please refer to the Windows help docu-
mentation which explains these features in detail.

Make sure that your Dartcom security device is connected to your computer
before starting MAP or MacroPro, otherwise you will be prevented from using
the software.

Document windows
There are three types of document window in iDAP and MacroPro:
• Image document windows.
• Fax document windows.
• Animation document windows.
Document windows can be minimised to an icon by clicking , maximised to fill the
application's work area by clicking II1 and closed by clicking Ei.

Image document windows


An image document window (an example of which is shown in figure 2.1) consists of a
text area at the top, and an image area at the bottom of the window. The relative sizes of
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
L2 -2 n -t er-s -'--- c4sw,an - --.-: r

these areas can be adjusted by dragging the horizontal divider between the two areas up
and down.

Figure 2.1
An example of an image
document window

Text area
The text area displays information about the image in the image area, such as the satellite
from which it was ingested, the type of image, date and time of acquisition and any other
relevant data. The information can be scrolled using the scroll bar on the right-hand side
of the text area. Initially, the text area is the height of one line of text, so only the up and
down buttons of the scroll bar are displayed. To enlarge the text area, drag the horizontal
divider between the text area and the image area downwards.

Image area
The image area displays the current view of the image file associated with the document.
In MAP, the view can be panned and scrolled using the horizontal and vertical scroll bars
or, when in pan and scroll mode, by dragging the mouse around on the image area (see
ViewPan and scroll mode in section 3). It can be magnified and reduced by switching
to magnification mode (see ViewMagnification mode in section 3). It can be
processed using the functions in the Processing menu (see section 3).

To use functions which operate on the image, the image area must be active.
" If the text area is active, the image functions are disabled. If the image area is
not active, click the mouse in it to make it active.

Fax document windows


A fax document window (an example of which is shown in figure 2.2) is identical in form
and function to an image document window, discussed above, with the exceptions that
the image area displays a fax chart rather than a satellite image, and certain image pro-
cessing functions are not available for fax documents.

USING THE SOFTWARE 2-3

Figure 2.2
An example of a fax
document window

Animation document windows


An animation document window (an example of which is shown in figure 2.3) consists of
an animation area and a set of animation controls at the bottom of the window. The ani-
mation can be magnified and reduced by resizing its document window.

• Figure 2.3
An example of an
animation document
window

4.. ;..
•'

-.-.

ue 16 Sep 2O31642

. 41 I - ----- -

Animation area
The animation area contains the document's associated QuickTime movie which displays
the images which make up the animation's frames, with the date and time of capture
shown at the bottom of each frame.

Animation, controls •
Play. Begins playback of the animation, starting at the current frame. During playback,
this button becomes the Pause button (see below).
2-4 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

II Pause. Pauses playback of the animation. When the animation is paused, this button
becomes the Play button (see above).
Previous frame. Displays the previous frame in the animation. This button is disabled
whilst the animation is playing.
Next frame. Displays the next frame in the animation. This button is disabled whilst the
animation is playing.
Position. Shows the position of the current frame within the animation. You can also
drag this slider to move quickly to different positions in the animation. The coloured area
shows the portion of the animation which has been selected for playback (see Set "in"
frame, Set "out" frame and Select all frames below).
Show tools. Displays a pop-up window (figure 2.4) containing various additional tools
and adjustments which can be applied to the animation.

Figure 2.4
The pop-up animation E X ( 1sec
took window
Speed:
xl x2 x3 x4 x5

Set "in" frame. Sets the start of the selected portion of the animation (the "in"frame) to
the frame which is currently visible. Can be undone by selecting Edit-Undo.
. Set "out" frame. Sets the end of the selected portion of the animation (the "out"frame)
to the frame which is currently visible. Can be undone by selecting Edit-Undo,
4 Select all frames. Selects all frames in the animation, setting the "in" frame to the first
ZE frame in the animation and the "out" frame to the last frame. Can be undone by selecting
Edit-Undo.
Set magnification to 1:2. Adjusts the size of the animation document's window to scale
the animation to half its actual size (1:2).
Set magnification to 1:1. Adjusts the size of the animation document's window to scale
the animation to actual size (1:1).
>< Remove current frame. Removes the currently visible frame from the animation. Can
be undone by selecting Edit-Undo.
Switch off looping. When this icon is displayed, looping during playback is on, which
sec means that when the end of the selected portion (the "out"frame) of the animation is
reached, playback continues from the start of the selected area (or the "in"frame) after a
short pause. Click this button to switch off looping. The button then becomes the Switch
on looping button (see below).
To the right of this button the delay to leave between loops can be adjusted. Use the arrow
buttons to increase or decrease the delay, in seconds.
Switch on looping. When this icon is displayed, looping during playback is off, which
means that when the end of the selected portion (the "out"frame) of the animation is
reached, playback stops. Click this button to switch on looping. The button then becomes
the Switch off looping button (see above).
The Speed slider allows the speed of playback of the animation to be adjusted. The
further to the right the slider is dragged, the higher the speed of playback of the anima-
tion, and the further to the left, the slower the speed.
USING THE SOFTWARE 2-5
- - -- -_•• --,et-- - - -r,;.?2 -S - - -. 3t r-- - - - R *--I

The application window


The iDAP application window (an example of which is shown in figure 2.5) consists of a
menu bar, a tool bar containing shortcut buttons for commonly used functions, a document
area, a read-outs panel and a status bar.
Figure 2.5 9-D -
Menu bar
An example of the IDAP
application window
TT-7-1 '
- - -
k?
-
-
- -- -
---- Toolbar

T\ \
N

pc - I
4-
- Read-outs panel

--
tl

-- , •_

.--.-- '-I

Status bar

The MacroPro application window is very similar, except that the read-outs panel is not
displayed and the range of available menu items and tool bar shortcut buttons is different.

Menu bar
The functions available in the menu bar are described in detail in section 3.

Tool bar
The tool bar contains shortcut buttons which correspond to menu items in the menu bar,
and is only visible if ViewToo1 bar (see section 3) is switched on. By dragging it with
the mouse, the tool bar can be positioned (or docked) horizontally or vertically around the
edges of the application window, or can be undocked into its own resizable floating
window. A floating window is one which can be moved anywhere on the screen and stays
on top of all other windows.
The range of shortcut buttons available differs between iDAP and Macro Pro and will vary
according to the type of document which is active, the functions available for that docu-
ment, and the types of data for which your software is licensed.
The complete range of shortcut buttons is described below.
Open document. Allows an existing image, animation or fax document to be opened
and displayed in a new window. Equivalent to FileOpen.
Create from raw. Displays a pop-up menu allowing Dartcom iDAP images to be created
from raw HRPT, CHRPT, SeaWiPS, AHRPT, DMSP and GVAR data. Equivalent to
FileCreate from raw.
Save document. Saves the active document using its current name, thereby updating the
- - existing copy on disk. Equivalent to FileSave.

[-6 j DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE


— weoz a. r V tt2.S .__....._.rrnwt1: it*itr'at r"

Print. Allows the active document to be printed, with or without map overlays, station
and reference points and latitude/longitude legends. Equivalent to File.Print.

v Cut. Moves the selected data (an area of an image, for example) on to the clipboard,
removing it from its current position. Equivalent to EditCut.
Copy. Puts a copy of the selected data (an area of an image, for example) on the clip-
board, without removing the data from its current position. Equivalent to EditCopy.
Paste. Pastes a copy of the data on the clipboard into the selected document. Equivalent
to EditPaste.
About. Displays the version number, date, copyright information and licensed compo-
? nents for your copy of iDAP or MacroPro. Equivalent to HelpAbout.
Help. Changes the mouse cursor to the "help" cursor. Click any object to display the help
information for that object.

J Enhance. Allows the selected image document to be enhanced to improve its visual
appearance or highlight particular features. Equivalent to ProcessinpEnhance.
Restore from original data. Restores the view of the active image document to show the
original data, as it was when the image was ingested. This removes any image processing
which has been applied to the image. Equivalent to ViewRestore from original data.
Formula palette. Allows a formula palette product to be generated for the active image.
Equivalent to ProcessingFormula palette....
Show palette key. Shows the Key window for the active image document, which allows
colours on the image to be matched to formula values. Equivalent to ViewPalette
key.
Toggle pan and scroll mode. Switches on or off pan and scroll mode. When switched
on, document views can be panned and scrolled by dragging the mouse over the image
area. Equivalent to ViewPan and scroll mode.
Toggle magnification mode. Switches on or off magnification mode. When switched
Q on, documents can be magnified and reduced using the left and right mouse buttons
respectively. Equivalent to ViewMagnification mode.
Rotate 900. Rotates the view of the active image or fax clockwise through 900.
° Equivalent to ProcessinpRotate90°.
Polar navigate. Navigates (places an overlay on) the active image document. Applies
only to polar-orbiter images which have not already been navigated. Equivalent to
NavigationPolar navigate.
Toggle overlay adjustment. Switches on or off nudge overlay mode. When switched on,
4'
it allows the overlay on the active image to be moved to correct any inaccuracies after the
image has been navigated. Equivalent to NavigationNudge overlay mode.
Toggle profiling mode. Switches on or off distance, bearing and profile mode. When
-'' switched on, it allows a line to be drawn on the image and a profile along this line to be
displayed. Equivalent to NavigationDistance, bearing and profile.
Projection transform. Allows the active image to be projected to a standard projection,
with slicing and masking. Equivalent to NavigationProjection transform....
Blue Marble masking. Allows a mask to be generated from NASA Blue Marble data and
applied to the active image. Equivalent to NavigationBlue Marble masking....
USING THE SOFTWARE 2:7

, DEM masking. Allows a mask to be generated from Digital Elevation Model (DEM) data
and applied to the active image. Equivalent to NavigationDEM masking....
Toggle station position. Switches on or off display of the station position marker, which
- appears on images as an orange circle. Equivalent to ViewStation position. The
station position marker can be switched on or off and its title configured using
NavigationReference points...).
Toggle reference points. Switches on or off display of markers for each of the reference
4à points, which appear as blue circles on images. Equivalent to ViewReference points.
Reference points can be configured and switched on or off according to requirements (see
NavigationReference points...).
rt Toggle overlays. Switches on or off automatic display of overlays on images. Equivalent
to ViewOverlay.
xi Toggle lat/lon legends. Switches on or display of grid line legends (or labels) at the
im-r- edges of images. Equivalent to ViewLat/lon legends.

Document area
The document area can contain any number of document windows of the types described
earlier in this section, in minimised, normal or maximised states.

Read-outs panel
The read-outs panel (figure 2.6, overleaf) is only available in iDAP. It contains a number
of data read-outs which correspond to the pixel under the mouse cursor (or the active
document if the mouse is not over a document window). It is only visible if ViewRead-
outs panel (see section 3) is switched on. By dragging it with the mouse, the read-outs
panel can be positioned (or docked) on the left or right sides of the iDAP application
window, or can be undocked into its own floating window. A floating window is one
which can be moved anywhere on the screen and stays on top of all other windows.

2-8 DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE


e .. ---.- - .- -.-a-.-- ..- - --, ••••._.- -

Figure 2.6
Station position:
The read-outs panel N 50*34.56
00356.! I Geographical location of station position
Cursor position:
Geographical location of cursor position

1200 i'• Cursor position relative to top-left corner (0,0)


Sun zen: Sunaz:
1 "J Sun zenith and azimuth angles at cursor position
Distance: Bearing:
h1•
1686. Distance from station position to cursor position
1104.5km
596AnmU Bearing from station position to cursor position
Meg: Size: 08
[2os •121 Magnification and image size (in pixels)
Plan- infrmtn: Plane colour
Type of data on plane
Raw value of pixel under cursor
Type of calibrated data on plane
oct dassification Calibrated value of pixel under cursor (if available)
Classification value of pixel under cursor (if available)
ch ________ Click the radio button next to a plane colour to display
O only that plane or combination of planes

classification

• K4]
Temperature
-51.7CC (-6 1.
rouct dassification

Product:
kRL,1J 4WuJ Type of product (formula palette products only)
_____________ _________ Calculated product value or classification of pixel
41. 711 under cursor (formula palette products only)

Station position is the current station position, obtained from the chosen source (see
Utilities-Configuration... in section 3). If the station position could not be obtained, an
error message is displayed instead. "(not available)" indicates that a station position
could not be obtained from the selected source. "(no active unit)" indicates that auto-
matic position updates are enabled, but the configured source could not be found.
"(invalid/fixing)" indicates that the source has been found, but is not yet able to provide
valid positions.
Cursor position shows the latitude and longitude of the image pixel under the mouse
cursor. The image must be navigated for this read-out to be displayed (see the
Navigation menu in section 3).
X and Y show the horizontal and vertical coordinates respectively of the image pixel
under the mouse cursor, relative to the top-left corner of the image (0,0). Sun zen and
Sun az show the sun zenith and azimuth angles respectively of the image pixel under the
mouse cursor.
Distance shows the distance (in miles, kilometres and nautical miles) from the current
station position to the image pixel under the mouse cursor. Bearing shows the bearing to
the image pixel under the mouse cursor graphically (on the compass) and numerically.
The station position must be valid for these read-outs to be displayed.
USING THE SOFTWARE 2-9

Mag shows level of the magnification at which the image document under the mouse
cursor is currently being viewed, with 1:2 being half size, 1:1 being actual size, 2:1 being
double size, and so on. Size shows the width and height, in pixels, of the image document
under the mouse cursor.
The Plane information area shows the raw and calibrated data types, raw and calibrated
value read-outs and classification read-out for each plane in the image under the mouse
cursor (or the active image document if the mouse is not over an image). If a multi-plane
image (except a formula palette product) is active,use the radio buttons to display the
individual greyscale planes or view it as a colour composite.

If a temperature calibration offset has been applied to an APT image, the


¶J'1 calibrated data read-out will have a '+' symbol appended to it to indicate that
it has been adjusted.

Product shows the product type and calculated value or classification of the image pixel
under the mouse cursor for formula palette products (see ProcessingFormula
palette... in section 3).

Status bar
The status bar contains a number of status panes. It is only visible if ViewStatus bar
(see section 3) is switched on. The left-most status pane gives brief help information for
the button or menu item under the mouse cursor, and displays status information when
iDAP or MacroPro is performing a task. The next pane to the right is a progress indicator,
which shows the progress of lengthy operations.
Next is a message which shows whether or not automatic document updating or process-
ing (see below) is switched on or off. To the right of to it is an activity indicator which
changes every ten seconds when switched on to show that the automatic update or pro-
cessing mechanism is functioning correctly.
The right-most status pane shows whether iDAP or MacroPro is locked or unlocked (see
UtilitiesSecurity... in section 3). When locked, sensitive functions of the software are
made unavailable to prevent unauthorised tampering.

Automatic document updating


If UtilitiesAutomatic update (see section 3) is switched on in MAP, all open document
windows are checked every minute to see if their data files have been updated by their
associated acquisition systems, or by MacroPro if automatic processing is being per-
formed on them (see below). The windows of documents which have changed are
updated to show the new data, thereby keeping the contents of all open document
windows as up-to-date as possible.
A message and activity indicator in the status bar show whether or not automatic docu-
ment updating is switched on and, if so, its status. The indicator changes every ten
seconds when automatic updating is switched on to show that it is functioning correctly.
When an animation document window is being updated, the animation area of the
window is disabled for the duration of the update.
[2:10 1 DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE
flfl

1,?ti.atic ....... . . * . . . . . . . . * *......


The MacroPro software can be used to perform automatic processing on image docu-
ments each time they are updated by their associated capture systems.

To start MacroPro, select StartProgramsDartcomMacroPro, or Utilities.


do))) Start MacroPro... from within MAP. If you want MacroPro to run
automatically each time you start up the computer, place a shortcut to it in the
Startup folder of your Start menu.

If Uti1itiesAutomatic processing (see section 3) is switched on in MacroPro, all image


documents in the active macro set (see Uti1itiesAutomatic processing settings..., also
in section 3) are checked every minute to see if their data files have been updated by their
associated acquisition systems. This process works as follows:
O The first image in the macro set is checked to see if it has been updated. If
not, go to step 0.
O The image is opened automatically if it is not already open in MacroPro.
O The processing operations configured in the image's associated macro are
performed in sequence in the order in which they appear in the Automatic
processing window.
O The image is closed automatically if it was opened in step 0.
O If all images have been checked, the process is stopped, otherwise continue
to step 0.
O The next image in the macro set is checked to see if it has been updated. If
so, go to step 0, otherwise go to step 0.
Certain types of processing may require two or more separate macros to complete
because they include operations (such as reprojection and formula palette creation) which
produce new image documents. For example, to create an animation of a formula palette
product, the first macro would create the product as a new image document, and the
second macro would operate on the new document and create the animation.
A message and activity indicator in the status bar show whether or not automatic process-
ing is switched on and, if so, its status. The indicator changes every ten seconds when
automatic processing is switched on to show that it is functioning correctly.
3-1

SECTION

Software menu reference

Introduction - - - •tt.O t*

This section describes how to use the various functions of iDAP and MacroPro. MacroPro
provides a small subset of iDAP's functions together with additional functions for control-
ling and configuring automatic processing.

Conventions used in this section


To allow information about particular menu functions to be found quickly and easily, this
section employs several conventions. Each menu always begins at the top of a new page.
In the margin next to the menu title is its initial letter. All functions within the menu are
also labelled with this initial letter. If a menu item has an associated tool bar shortcut
button, it is shown next to the menu identifier. For example, the following item belongs to
the File menu, and has an associated tool bar shortcut button.

Open...

When describing a sub-menu of functions, the initial letter of the menu in which the sub-
menu appears is followed by an arrow (), indicating the item belongs to a sub-menu,
followed by the initial letter of the sub-menu title. For example, the following belongs to
the Flip sub-menu, which in turn appears in the Processing menu.

P. L: Horizontal
When iDAP or MacroPro is locked (see Uti1itiesSecurity. .), sensitive functions will be
disabled. Such functions are indicated by a "key" symbol, as in the example below.

Ji Configuration... G-ri

Some functions may not be available if your software licence does not include permission
to use them. Such functions are identified in this section by a "padlock" symbol, as in the
DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE

example below, and may be enabled, if required, by purchasing additional licence compo-
nents from Dartcom.

[F>iE1>rW PCIGeomatica... G-nfl


Functions which are available only in MAP are identified by a small MAP icon, as in the
example below.

Save as...G-ii

Functions which are available only in MacroPro are identified by a small MacroPro icon,
as in the example below.

rjj Automatic processing settings... 0 G-r'


SOFTWARE MENU REFERENCE 3-3

File menu
0040,,.,a.e , S ............ S 4 .................... • SSS0

The File menu provides functions for opening, closing, saving, importing, exporting,
merging and printing documents. In the lower part of the menu, a list of the most
recently used documents is maintained.

23 t F Open...
Allows an existing image, animation or fax document to be opened. The Open window
(figure 3.1) is displayed. It is similar to the standard Windows Explorer window.

Figure 3.1 - - -
The Open window Luuk, j0 Sample images - - - {i
(FiIeOpen ... ) (Th- Name Date modified Type Ice
Details of selected file
Date. 061, 24 Jul 1999
t ] 92 (Northern Hewrsph 15,0912002 isis ,DAP image ] Tore' 089103 (DM14000)
R ecerrt P1 aces 'jj 9J9) bow dd Satellite: Feng Ton
09/12/1999 15,54 SAP wae Format: CHSPT image
j 9W (whole earth) dd 09,1219991347 PAP image ,rc Type Mult,plarre
- A 020 (Europe) did 03/07'2000 1352 DAP image
FV/1 Preview;
Desktop ] (TOT (whole earth) .did 03/0712000 13:52 DAPwage
ir- )
02 (Europe) .did 0307,2000 13.52 DrOP wage
J D2 (Europe) drr,d 03107/2000 13.52 PAP animation
Dartcow ) 0101 (whole earth) cOd 03 107/2000 1351 iDAP image
j 0101 (whole earth) ci 03/07/20001351 PAP animation I
] Gibraltar SOT dd 081121'1999 16:17 iDAPimage 1' '

Computer L01 DM5 North cOd 03/07/2000 1351 DAP image


— DM5 North.dwd 03/07/20001350 iDAP animation
L ltalv.cbd 08112,'199914:35 iDA1 waoe
Network
Pie name: rOgal bloom Ad
F8ntoI type: [plroAPdocuwentsrtci,'td, 4md) Cancel I L Open

The list of document files displayed is filtered according to the type selected in the Files of
type drop-list. Choose the document to load from those available. The Details of
selected file area shows information about the selected document and a preview of the
document if the Preview tick-box is switched on.
Click Open to open the document. The selected file is loaded and displayed in a new doc-
ument window.

'c Create from raw sub-menu


The Create from raw sub-menu allows various raw satellite data formats to be sub-
sampled and imported into iDAP manually for viewing and processing.

F C HRPT...G-ii
Allows an HRPT raw file (ingested by the Dartcom Polar Orbiter Ingester software, for
example) to be sub-sampled and imported into iDAP for viewing and processing. The
HRPT sub-sampler window (figure 3.2) is displayed.
3-4 1
DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE
L*i7.W fl 7... ... .n*g -J - . ..................- t -

Figure 3.2
The HRPT sub-sampler Path: mat4f4RPT - [Choose... } [j]

window (FileCreate Image: Thu Apr 20, 2059 13:30:32 (GMT+1:S0)

from raw .HRPT ... ) NOAA 19, Northbound, to East, 4215 men, channel 3A
Planes 5-bit reduction
3 Singla plane IA. Automatic

•E11 Minimum
Maximum
Diolsar
®M1d5-plane
83 2.4% 763 61% 3

E r2 t 57 1.0% 732 63.2% 3


----
II ©
Histogram for channel I

P^
0 1128 256 384 512 640 718 596

Saberample
p
1:1 1:32
Size
Width: 0 foods . Selecta6

Height: 0 pixels Select none

options
Missing data: © Black tine [Map overlays...
® Repair
Enhancement: Histogram equalisation -- - ..IEI]
View
Preview . Creutod those

Show overlays
['evreimsce] Idndnn overlays[ -eI1 Open last saved document when window is dosed [.. _Close--

The current data path is shown in the Path box. Click the Choose... button to change it if
required. The HRPT data path window (figure 3.3) is displayed.

Figure 3.3
The HRPT data path Choose a folder which contains archised HO yT data.
76 A:
window i isso C:
76 - 0:
^
76 L n SASCVCLE.EIN
176DartOuni
W b Data
76 AHOPT
lIt 01097
76 t DM09
76 ô GOES LOST
76 ILD OVAR
76
76 I 2009-05-12
193 2009V513
:0 ILI SeaVdFs

rMake_newfolder.., - Cancel J[ _OK j


Navigate to the required folder or click Make new folder... to create a new one in the
selected folder, then click OK to return to the HRPT sub-sampler window.
The images found in the specified path are listed in the Image drop-list. Select an image
to sub-sample from those available. More information about the selected image is shown
below the drop-list and a preview is shown on the right-hand side of the window. Use the
Show overlays tick-box to show or hide the preview's map overlays. Move the mouse
over the preview to obtain latitude and longitude read-outs.
To refresh the list of images to ensure it shows the latest data, click Refresh. To select the
most recent image, click Latest.
SOFTWARE MENU REFERENCE 3-5

Planes area
Choose whether to create a single-plane (greyscale) or multi-plane (false colour) sub-
sample using the Single plane and Multi-plane radio buttons. If Single plane is
selected, choose the image channel to use from those available in the drop-list. If Multi-
plane is selected, choose the image channel to assign to each image plane (red, green and
blue) using the respective drop-lists.

8-bit reduction area


Each HRPT channel has a data resolution of 10 bits per pixel. To use it within iDAP the
resolution must be reduced to 8 bits per pixel by specifying the required minimum and
maximum pixel values for each channel. A suitable divisor is then calculated from these
limits. The limits can either be calculated automatically using a statistical analysis to
maximise the range of pixel values or specified manually if maximum data resolution is
required or you are interested in a particular range of pixel values.
The current limits and divisors are shown in the grid opposite their corresponding
channel selection drop-lists. The limits are shown as raw pixel values and their corre-
sponding calibrated values. Use the radio buttons next to each channel selection drop-list
to view each channel's histogram and limits on the graph at the bottom of the area.
Switch on Automatic to use the automatically calculated limits, or switch it off to specify
them manually and use the Min and Max sliders on the graph to set the limits for each
channel. The divisor is calculated automatically according to the selected range.

Sub-sample area
Set the required sub-sample factor using the slider or arrow buttons. The factor is dis-
played between them. A factor of 1:2 results in an image half its original size, 1:3 a third
its original size, and so on. If an area has been selected on the image preview the size of
the resulting image (in pixels) is shown in the Width and Height boxes in the Size area.

Size area
Select the required area to sub-sample by drawing a box on the image preview on the
right-hand side of the window using the mouse. The box can be moved by dragging
inside it and resized by dragging the edges and corners.
The size of the resulting image is shown in the Width and Height boxes, taking into
account the sub-sample factor set in the Sub-sample area. To select the whole image,
click Select all. To clear the current selection click Select none.

Options area
Use the Missing data radio buttons to choose how to handle missing image data. Black
line simply inserts blank data. Repair attempts to recreate the missing data using a
graduated averaging algorithm. This works well for single missing lines but can result in
strange effects for large blocks of missing data.
Select the enhancement profile to apply to the resulting image using the Enhancement
drop-list. The range of profiles and their effects on images are shown in table 3.3 (see
ProcessingEnhance ... ).
If required, adjust the map overlay settings by clicking Map overlays.... The Overlay
settings window (figure 3.35) is displayed. See NavigationOverlay settings... for
more information.
3-6 1 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
- —-- W - - 4r sr -'tg..

View area
After creating the sub-sampled image you can switch between it and the image preview
using the Preview and Created image radio buttons. This is to enable the selected area
to be adjusted until you are happy with it.

Creating the sub-sampled image


After selecting the required area on the image preview (see Size area) and configuring the
options as required, click Create image to create the sub-sampled image. The window
enlarges and shows the resulting image in place of the preview. Use the Show overlays
tick-box to show or hide the image's map overlays. Move the mouse over the image to
obtain latitude and longitude read-outs.
If the area covered by the image is not as required, click Preview in the View area, move
or resize the box on the preview as necessary and click Create image again.
If the map overlays are not correctly aligned with the image, click Nudge overlays and
drag the overlays into the correct place on the image. Click Nudge overlays again when
you have finished.

Saving the sub-sampled image


When you are happy with the resulting image, click Save as... to save it as a new iDAP
image document. The Save as window (figure 3.5) is displayed. Enter a name for the
document and click Save.
When you have finished creating sub-sampled images, set the state of the Open last saved
document when window is closed tick-box as required, then click Close. If the tick-box
was switched on, the image last saved in the HRPT sub-sampler window is opened auto-
matically in a new document window.

CHRPT... ji
Allows a CHRPT raw file (ingested by the Dartcom Polar Orbiter Ingester software, for
example) to be sub-sampled and imported into iDAP for viewing and processing. The
CHRPT sub-sampler window is displayed. It looks and works the same as the HRPT
sub-sampler window (figure 3.2) described in FiIeCreate from rawHRPT.

! SeaWiFS... S G-n fl
Allows a SeaWiFS raw file (ingested by the Dartcom Polar Orbiter Ingester software, for
example) to be sub-sampled and imported into iDAP for viewing and processing. The
SeaWiFS sub-sampler window is displayed. It looks and works the same as the HRPT
sub-sampler window (figure 3.2) described in FileCreate from rawiHRPT.

AHRPT... 0, .-n fl
Allows an AHRPT raw file (ingested by the Dartcom Polar Orbiter Ingester software, for
example) to be sub-sampled and imported into iDAP for viewing and processing. The
AHRPT sub-sampler window is displayed. It looks and works the same as the HRPT
sub-sampler window (figure 3.2) described in File-Create from rawHRPT....

DMSP...G-nfl
Allows a DMSP raw file (ingested by the Dartcom Polar Orbiter Ingester software, for
example) to be sub-sampled and imported into iDAP for viewing and processing. The
DMSP sub-sampler window is displayed. It looks and works the same as the HRPT sub-
sampler window (figure 3.2) described in FiIeCreate from rawHRPT....
SOFTWARE MENU REFERENCE 3-7
- - - - - a- ------------------I -

- - - GVAR..JG-n
Allows a GVAR level 0 file (ingested by the Dartcom GVAR Ingester software, for example)
to be sub-sampled and imported into iDAP for viewing and processing. The GVAR sub-
sampler window (figure 3.4) is displayed.

Figure 3.4 laVAtisub-varopler -------- -TTTT


The GVAR sub-sampler LA film C:lDartcom'ataVAR'V_12_02877063360927717780_75 1ti-55]glO
J. Sub-sample level
window (FiIeCreate
from rawG VAR...)
Area
X: Lii1 lrridtla EIIIII1
Y llaiehtr
[select nsoxireum] [Select none

Channels Oversunrple
-I
L1er
1 (4km)

E[ (000e) - - -
Options
[] Repair tines
Enhoncement:
[Min-oax - -
[overl]

Cursor position
Latitude:
Longitude:
Slew
© Quicidook
- Sub-sampled osave

11
)Open last saved document
le --liii [.. close I

Click the Choose... button to choose a GVAR level 0 file to sub-sample. The Select GVAR
level 0 file window is displayed, which is similar to the Open window (see FileOpen ... ).
Choose the required GVAR level 0 file and click OK. The Quicklook for this level 0 file is
then displayed.

Sub-sample level area


Set the level of sub-sampling required for the resulting image using the slider. 1:1 is full
resolution, 1:2 is half resolution, and so on. The higher the resolution, the larger and more
detailed the resulting sub-sample.

Area area
This area shows the position and size of the area of the frame selected for sub-sampling.
Using the mouse, drag out a box around the area of the image you want to sub-sample.
The box can be resized by dragging the mouse on its edges and corners, and moved by
dragging the mouse inside it. To sub-sample the whole frame, click Select maximum.
To clear the selected area, click Select none.

Channels area
This area allows raw GVAR data channels to be assigned to image planes. Whilst GVAR
data consists of five channels, sub-sampled images comprise only three planes (red, green
and blue) for multi-plane images, and one plane for greyscale (single-plane) images.
Some GVAR channels have a lower resolution than others. For example, whilst the visible
channel's resolution is 1km, the infra-red and near infra-red channels are 4km and water
I3-871 DARICOM IDAP/MACROPRO SOFTWARE USER GUIDE

vapour 8km. If the sub-sample level would produce an image with a higher resolution
than one of the selected channels, an oversample warning icon is displayed next to the
drop-list for that channel, indicating that the channel's data will be oversampled
(expanded to match the required resolution without actually gaining any detail).
Using either the red, green and blue drop-lists (for a multi-plane sub-sample) or the
greyscale drop-list (for a single-plane sub-sample) choose which channel you want to
assign to which plane. Assigning visible to red and green and infra-red or near infra-red
to blue produces a "realistic" false-colour image. With experimentation, other channel
combinations can be used to show particular features of the image.

Options area
If you want missing or corrupt lines in the raw data to be repaired in the sub-sampled
image, switch on Repair bad lines. The repair process uses graduated averaging to
create an almost seamless repair, but for large blocks of bad lines this may lead to a "candy
stripe" effect. If the Repair bad lines option is switched off, bad lines will be coloured
black in the sub-sampled image.
Choose the enhancement profile you want to apply to the sub-sampled image from those
available in the Enhancement drop-list. If you do not want the image to be enhanced,
select Linear.
If required, adjust the map overlays by clicking the Overlays.., button. The Overlay set-
tings window (figure 3.35) is displayed, described in Navigation.Overlay settings....

Cursor position area


When the mouse is over the Quicklook, the latitude and longitude at the cursor position
are displayed in this area.

View area
When a sub-sample has been created, the radio buttons in this area allow the view to be
switched between the Quicklook and the sub-sampled image.

Creating the sub-sample


Once the sub-sample settings have been specified and the area to sub-sample chosen,
click Create sub-sample to create the sub-sampled image. When this is complete, the
sub-sample is displayed in place of the Quicklook. If you are not happy with it, re-display
the Quicklook (using the Quicklook radio button in the View area), adjust the sub-
sample settings and area as necessary, then click again on Create sub-sample.

Saving the sub-sample


When you are happy with the sub-sampled image, click Save as... to save it as an MAP
image document. The Save as window (similar to that shown in figure 3.5) is displayed.
Enter a name for the document and click Save. The image is saved and you are returned
to the GVAR sub-sampler window to allow further sub-sampled images to be created if
required.
When you have finished creating sub-sampled images, set the state of the Open last saved
document tick-box as required, then click Close. If the tick-box was switched on, the
image which was last saved in the GVAR sub-sampler window is opened automatically in
a new document window.

rF, Close
Closes the active document window. Equivalent to clicking in the title bar of the
document window.

SOFTWARE MENU REFERENCE 3-9


-. . . . - -...........;^,,-. - __.-_=.n_ — ;..W.- -- -w •0 -. -, -S.e! * 5 •

SaveG-n
Saves the active document using its current name, updating the copy currently on disk.

,F. Save as...iiG-n


Allows the active document to be saved to disk with a new name. The Save As window
(figure 3.5) is displayed.

Figure 3.5 save, as


The Save as window Save in: '4' Sampmages 4
Size ., Details of selected 61e
(FileSave as...) Name Date modified Type (not available)
Al (Northe He ,ph 05108/'002 13 15 DAP wage
Recent Places
j Algal bloow.did 00112/0899 15:54 DAP —age
1 JAW (whole earth).did 09/12/1999 10:47 lOOP wage
j (20 (Europe).did 03/07/2000 13:52 lOOPwage =
Desktop (TOT (whole earth(,did 03/0712000 13:52 100P image
02 (Europe).did 03107/2000 13:52 lOOP image
0T0T (whole earth)did 03107/2000 13:51 lOOP image
Dartcow ( Gibraltar S$T,did 08/12/1999 18:17 iDAP wage
DG DM5 North.did 03/07/2000 13:51 lOOP image
Oki [Ell ttaly.did 00/12/1999 14:35 iDAP image
Computer LR (South America(did 03/07/2000 13:50 iDAPimage
- LV (North America).did 00/07/2000 13:49 iDAP image
L l Mediterrane,n.did
.in....................
0911211999 10:46 lOOP wave
-
Network
File name
- Save as type: [iDAPingel.Id) . - . L Cancel [ Save j

The list of files displayed is filtered according to the type selected in the Save as type
drop-list. The file type is set automatically according to the type of file being saved, and
should therefore not be changed. Enter a name for the file, then click Save. The active
document is saved to disk with this name.

F1 Save all modifiedE3 0-in


- Saves all documents which have been modified but not yet saved. Equivalent to selecting
File-Save for each document.

F Delete...G-n
Allows one or more iDAP documents to be deleted, together with all their associated data
files. The Delete window (figure 3.6) is displayed.

Figure 3.6 JP 0eNte


The Delete window Look in. j4 Sample images
(FileI . Delete ... )
Name (0 ... Date modified Type Si
Details of selected Re
Date: Tue, 200011991
12 (Northern Henrisph.,. 15/01:2002 13:15 iDOP wage Time: 14:57:05 (GMT+0:00)
Recent Places )(j Algal bloow.did 01/1211999 15:54 DiP image jFor m a 5: IRPT image
Type: SOT product
JAW (whole earth(.did 09/12/1999 19:47 1DAP image

Desktop
no
(20 (Eorope).did

02 (Europe).did
03/07/2000 13:52
(TOT (whole earth).did 03/07/2000 13:52
03/07/2000 13:52
iDAP image
OAF image
GAP image
:j ---- .__-
C

j 02 (Europe).dnd 03/07/2000 13:52 iDAP animation


Dartcow OTOT (whole earlh).d:d 03/07/2000 13:51 J iDAP image . 1

j OTOT (whole earth).d,., 03/07/2000 13:51 DiP animation .


ilk"
b alta SOT
dd 0_8.112./1.9.9.916.17 DAP wage
Computer J OMS North,did 03/07/200013:51 iDAP,mage
10 1 DM5 North.dmd 03/07/2000 13:50 iDAP animation
ltalv.clid
.
L 01/12/199914:35
i0u
l iD4P iwaoe
_-
• I -_.v
Network .-----..----.--------.----_________ I,

Me name Gibratar SST.Ad


Files oftype: [PiDAPdocsooenta(thd4fd,dmd) - _] [ Cano [ C)eletejj

L;3101 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE


-uw---'-'e-wm- . -----___-.-•-__- - -..-=-.------ -,

Once iDAP documents have been deleted, they cannot be retrieved. Make
absolutely sure that you no longer want to keep the selected documents
before deleting them.

The list of files displayed is filtered according to the type selected in the Files of type
drop-list. Choose the files to delete from those available. If only one document is
selected, the Details of selected file area shows information about the selected document
and a preview of the document if the Preview tick-box is switched on.
Click Delete to delete the selected files. A window appears asking you if you are sure that
you want to delete them. Click Yes to delete the files, in which case the selected files and
all associated data files are then deleted, or No to cancel the delete operation.

t- 1 T] Import sub-menu
The Import sub-menu allows various legacy and third-party data formats to be imported
into iDAP for processing.

m HRPT/CHRPT Grabber raw... E3 G-n


Allows raw HRPT, CHRPT and SeaWiFS data ingested using the Dartcom HRPT/CHRPT
Grabber software to be imported into iDAP for processing. The import process creates
additional ancillary files in the formats used by the Dartcom Polar Orbiter Ingester soft-
ware. The original data files are not destroyed or modified in any way.
The HRPT/CHRPT Grabber raw importer window (figure 3.7) is displayed.

Figure 3.7
The HRPT/CHRPT
Sourcepath: cartcomata4PPT choose...I
Grabber raw importer Name Date Time
window (Filelmport E] ArthOl Sri, Sep 14, 2001 06:40:33 (GMT +0:50)
Artho2 Moo, Apr 09, 1999 22:40:46 (GMT +0:00)
HRPT/CHRPT Grabber ii
raw...) E) Aoch17
E] Arch IS
Moo, Nov 15, 1999 09:41:46 (GMT +0:00)
Wed, May 19, 1999 15:53:12 (SMT-+0:00)
C] ArthOS Moo, Apr 9, 2001 09:58:14 (GMT +0:00)
E] Arth20 Moo, Nov 15, 1999 12:12; 24 (GMT +0:010)

NOA.A 16, Narthbmand, 4271 Sees


Destination path:
® Same as source
© Ct'Dartcom'Data\KRPT oose...j
0 Delete exlsOnn images in this folder
Show overlays
Select aj [select none - Irepoct select ages [cJ
SOFTWARE MENU REFERENCE [ 3-11]
-

The current data path is shown in the Source path box. Click the Choose... button to
change it if required using the Source path window (similar to that shown in figure 3.3).
Any images found in the specified path are displayed in the list on the left-hand side of the
window. Click an image to see more information about it below the list and display its
preview (if any) on the right-hand side of the window. Use the Show overlays tick-box to
show or hide the preview's map overlays.
Tick the boxes corresponding to the images you want to import. Click Select all at the
bottom of the window to tick all images, or Select none to clear the current selection.
Use the Destination path radio buttons to choose where to save the imported data. Click
Same as source to use the path specified in the Source path box, or click the second
radio button and click Choose... to specify an alternative path. In this case a copy of the
raw data file is created in the destination path in addition to the ancillary files. Switch on
Delete existing images in this folder if you want any existing images to be deleted from
the destination path before the selected images are imported.
When you have selected the required images and configured the destination path, click
Import selected images to begin importing. When complete, use the Fi1eCreate from
raw sub-menu to create iDAP image documents from the imported data, or the
FileExport sub-menu to export it to various third-party formats.

:j Dundee standard raw... B I-n fi


Allows raw HRPT data in the Dundee University standard raw format to be imported into
iDAP for processing. The Dundee standard raw importer window is displayed. It looks
and works the same as the HRPT/CHRPT Grabber raw importer window (figure 3.7)
described in File'Import'HRPT/CHRPT Grabber raw....

- E Export sub-menu
The Export sub-menu allows the active image or fax document to be exported to various
image and data file formats.
Via further sub-menus it also allows raw HRPT, CHRPT, SeaWiFS, AHRPT and DMSP data
to be exported to various third-party formats including PCI Geomatica, ERDAS
IMAGINE, ENVI/IDL, NOAA level I and SeaWiFS level 0. This section describes the full
range of exporters but not all are available for all types of data.

-El Image...G-n
Allows the active image or fax document to be exported to common graphics file formats.
The Image export options window (figure 3.8) is displayed.
[_3-12 DARTCOM IDAP/MACROPRO
.a
SOFTWARE USER GUIDE
ft \4-. . - •-4r•-,' - •ft• .-. -& .è- - t----W-ft . -

Figure 3.8
The Image export
options window
(FileiExport Image. .4

Area area
This area allows the area of the image to export to be chosen. To export the whole image,
switch on the Whole image tick-box. To export an area of the image, switch off Whole
image and, using the left mouse button, draw a box on the image preview around the area
you want to export. The box can be resized by dragging the mouse over its edges and
moved by dragging the mouse inside its edges. The position and size of the box is shown
below the Whole image tick-box.

Options area
This area allows various optional items to be switched on or off. The Title tick-box con-
trols inclusion of the file name and image details at the top of the exported image. The
Information tick-box controls inclusion of the image's additional information text (dis-
played in the text area of its document window below the date and time) at the bottom of
the exported image.
The remaining tick-boxes will only be available if the document is a navigated image.
Maps and grids controls inclusion of the map overlays and grid lines configured for the
document. Station position controls inclusion of the station position indicator.
Reference points controls inclusion of the currently enabled reference points (see
NavigationReference points...). Lat/lon legends controls inclusion of latitude and
longitude labels at the edges of the image. If Lat/lon legends is ticked, choose the fre-
quency of the labels (in degrees) using the Frequency drop-list.

Exported images which have a formula palette (see ProcessingFormula


¶.J! palette...) will only include the palette's key (see ViewPalette key...) if the
Information tick-box is switched on.

Format area
This area allows the format for the exported image to be chosen. Choose the required
format from the drop-list. The formats available are BMP, TIFF, JPEG and PNG. If the
JPEG format is chosen, the Quality slider can be used to specify the quality of the
exported image. 0% gives the lowest quality (highest compression) and 100% the highest
SOFTWARE MENU REFERENCE 3-13
L
a..ax e-.axo-s -rs. m_... ,uv_r. - - : s-vvbudto - - - --. * - nfl.ts-, ------r—.,. --- ---nttvarss-ts-

quality (lowest compression). Use the Reduce to 8-bit tick-box to choose whether or not
to reduce the exported image to 256 colours (eight bits per pixel).

Exporting the image


After choosing the area to export and configuring the options as required, click OK to
continue, or Cancel to abort the export. If you clicked OK, the Save exported image as
window (similar to that shown in figure 3.5) is displayed. Enter a file name for the
exported image, then click Save to perform the export, or Cancel to abort the export
operation.

Data... E3 0-n
Allows the raw, calibrated or calculated data from a plane of the active image document to
be exported as a spreadsheet or binary file, for further analysis in third-party software.
The Data export window (figure 3.9) is displayed.

Figure 3.9 export -


Area
The Data export 5: 5:
Data
Plane © Latitudes
window [ö @ Red (chi) © Longitudes
© Green (di 2) Product values
(FiIei . ExportData ... ) Width: Height: © Blue (di 4) © Solar zenith angles
L] [iiI 4)i Pixel values
(D Solar azimuth angles
Sour -1—
- Selectares., () Rats values i Phase angles (eq PROP)
© Calibrated values
Format
@ Text (j Binary
Preset: [Comrna.separatednalues(CSV)
Cell delimiter Text qualifier
4): Comma 4)1 Double quote ©-_ --------
eL) Tab © Single quote )d05 (Start)
( Semicolon () (none)
t) Space Ldn-nvd:av
-
© Other:

Pile name
l] Butte automatically
C:Oartcorr\tmagesxparttlRPT dramiel 1 pixel ualxes.tut

[ase ]

Area area
This area shows the area of the image whose data will be exported. To change the selected
area, click Select area.... The Data export area window (figure 3.10) is displayed.
F.-
3-14 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

Figure 3.10
The Data export area
window

To select the whole image, switch on the Whole image tick-box. To select an area of the
image, switch off Whole image and, using the left mouse button, draw a box on the image
preview around the area you want to export. The box can be resized by dragging the
mouse over its edges and moved by dragging the mouse inside its edges. Its position and
size are shown below the Whole image tick-box. Click OK to use the new selected area,
or Cancel to revert to the previous one.

Data area
This area allows the plane and type of data to export to be chosen. If the image is multi-
plane, choose the required plane from those available in the Plane area. Choose the type
of data to export using the radio buttons in the rest of the Data area. The range of avail-
able types depends upon the characteristics of the image being exported. Most of the
types are self-explanatory.
The Phase angles option is useful for BRDF and other investigations, and exports the fol-
lowing calculated values (in degrees):
solar azimuth - satellite inclination + 900
90° is added to all values because the satellite inclination is greater than 90° for sun-syn-
chronous polar-orbiting satellites.

Format area
This area allows the format for the exported data to be chosen. Click the Text radio
button to export the data as a spreadsheet, or Binary to export it to a binary file.
If Text is selected, choose the required spreadsheet format from those available in the
Preset list. To export to a custom format, use the radio buttons in the Cell delimiter and
Text qualifier areas to configure the format options as required.
If Binary is selected, choose the required binary format from those available in the Preset
list, which includes Autosat (if licensed), GRIB (compatible with Synergie) and Cinesat (if
licensed). To export to a custom format, choose the required type for the data using the
Type drop-list and choose the required byte order using the Byte order drop-list.
SOFTWARE MENU REFERENCE 3-15

File name area


This area allows the name for the exported data file to be chosen. Switch on the Build
automatically tick-box if you want the name to be generated automatically from the
selected plane and type of data. To choose a custom name for the file, switch off Build
automatically. You can then edit the file name as required. To change the folder in
which the file will be saved, click Choose... and navigate to the required folder in the Save
as window which appears (figure 3.5) or the Save in window (similar to that shown in
figure 3.3) if Build automatically is switched on.

Exporting the data


After choosing the area to export and configuring the options as required, click OK to
export the data, or Cancel to abort the export operation. A window is displayed showing
progress and allowing the operation to be cancelled if desired.

HRPTsub-menu G -n

Allows raw HRPT data to be exported in various formats, including PCI Geomatica,
ERDAS IMAGINE, ENVI/IDL, GeoTIFF, and NOAA level 1 B.

PCI Geomatica... ER 0-ri


Allows raw HRPT data to be transformed to a user-defined map projection and exported
as a PCI Geomatica image. The HRPT PCI Geomatica exporter window (figure 3.11) is
displayed.

Figure 3.11 kPT pci

The HRPT PCI


Geomatica exporter
Path; C:'artcorn'Patal,HRPT

Image: Thu, Apr 30, 2009 13:30:35 (Gl'IT+l:OO)


[Choose..] [iiI
window 5100,0 19, Northbound, to East, 4215 lines, channel 30
Export settings
(FiIeiuExportiHRPT.PCI
Geomatica ... ) r1
Channels; Data:

2
LJ Raw
JCaibrated
Swathe:
© As ingested (55.4500')
55.50lD0T,
J Addilonal data

s I Summary; Raw data, Calibrated data, Solar zenith and azimuth,


Nazis to Dxel, Satellite indnalov

'lap option
[Earope
.H[t... Q

j Show overlays
5 j Show overlays

[Create peeview[ [;; [ rt a,


T]

The current data path is shown in the Path box. Click the Choose... button to change it if
required using the Data path window (similar to that shown in figure 3.3).
3-16 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
.= --.. •,,---- -. - -- .-.. - -. -a- SS -

The images found in the specified path are listed in the Image drop-list. Select an image
to export from those available. More information about the selected image is shown
below the drop-list and a preview is shown on the right-hand side of the window. Use the
Show overlays tick-box to show or hide the preview's map overlays. Move the mouse
over the preview to obtain latitude and longitude read-outs.
To refresh the list of images to ensure it shows the latest data, click Refresh. To select the
most recent image, click Latest.

Export settings area


Select the image channels to include in the exported image using the tick-boxes in the
Channels list. Use the Data tick-boxes to choose what types of data to include. Raw
exports the raw pixel values at full data resolution for each channel. Calibrated exports
the calibrated data values for each channel. Additional data exports the solar zenith and
azimuth, nadir to pixel and satellite inclination angles for each pixel. A summary of the
data that will be exported is shown under the tick-boxes.
Use the Swathe radio buttons to choose whether to use the satellite swathe angle stored
with the image or a custom figure.

Map option area


Choose the required map option from those available in the drop-list. A preview of the
area covered is shown below the drop-list. Use the Show overlays tick-box to show or
hide the preview's map overlays. Move the mouse over the preview to obtain latitude and
longitude read-outs. Use the 0. and 0. buttons to change the magnification of the
preview. Note that this does not affect the size or magnification of the exported image.
To edit or delete the selected map option or add a new one, click Edit.... The Map
options manager window (figure 3.36) is displayed. Use it to edit, delete or add map
options as required, then select the required map option and click Close. See
Navigation-Map options... for more information.
Not all projection types and earth models are supported by the PCI Geomatica software.
The projection types supported by the PCI Geomatica exporter are as follows:
• Equirectangular.
• Gnomonic.
• Lambert Azimuthal Equal Area.
• Lambert Conformal Conic.
• Mercator.
• Miller Cylindrical.
• Orthographic.
• Polar Stereographic.
• Polyconic.
• Robinson.
• Sinusoidal (Sanson-Flamsteed).
• Stereographic.
• Van der Grinten.
The earth models supported by the PCI Geomatica exporter are as follows:
• Airy.
SOFTWARE MENU REFERENCE 3-17
1
- ---- - - - - - -- •n'--. - -------- -

• Australian National.
• Bessel.
• Bessel 1841 (Namibia).
• Clarke 1866.
• Clarke 1880.
• Everest.
• Everest (India 1956).
• Everest (Malaysia & Singapore 1948).
• Everest (Malaysia 1969).
• Everest (Pakistan).
• GRS 1980.
• Helmert 1906.
• Hayford.
• Hough.
• Indonesian 1974.
• International 1909.
• International 1967.
• Krassovsky.
• Mercury 1960.
• Modified Airy.
• Modified Everest.
• Modified Mercury 1968.
• South American 1969.
• Southeast Asia.
• Sphere Radius 6370997m.
• WGS6O.
• WGS66.
• WGS 72.
• WGS84.

Exporting the image


When you have configured the export settings according to your requirements, click
Create preview. This calculates transformation matrices and creates a preview of the
exported image in the Map option area. If the map overlay does not align correctly with
the preview, use the button in the Map option area to increase the magnification of
the preview and click Nudge overlays. Drag the overlays so they align with the image,
then click Nudge overlays again.

The exported image is nudged to fit the overlay rather than the overlay being
—J"I nudged to fit the image. This ensures that the exported area matches that
defined by the map option. Do not worry that this is contradicted by the
image preview.
3-18 1 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

If the image preview looks satisfactory, click Export as... to export it to a PCI Geomatica
file. The Export image as window (similar to that shown in figure 3.5) is displayed.
Enter a name for the exported file and click Save to begin the export process.

riNH ERDASIMAGINE... IS G-rifl


Allows raw HRPT data to be transformed to a user-defined map projection and exported
as an ERDAS IMAGINE image. The HRPT ERDAS IMAGINE exporter window is dis-
played. It looks and works the same as the HRPT PCI Geomatica exporter window
(figure 3.11) described in FileExportHRPTPCI Geomatica....
The projection types supported by the ERDAS IMAGINE exporter are as follows:
• Albers Conical Equal Area.
• Azimuthal Equidistant.
• Equirectangular.
• Gnomonic.
• Hammer.
• Lambert Azimuthal Equal Area.
• Lambert Conformal Conic.
• Mercator.
• Miller Cylindrical.
• Mollweide.
• Orthographic.
• Polar Stereographic.
• Polyconic.
• Sinusoidal (Sanson-Fiamsteed).
• Stereographic.
• Van der Grinten.
• Wagner IV.
• Wagner VII.
The earth models supported by the ERDAS IMAGINE exporter are as follows:
• Airy.
• Australian National.
• Bessel.
• Bessel 1841 (Namibia).
• Clarke 1866.
• Clarke 1880.
• Everest.
• Everest (India 1956).
• Everest (Malaysia & Singapore 1948).
• Everest (Malaysia 1969).
• Everest (Pakistan).
• Everest (Sabah & Sarawak).
- ..T- , ca
SOFTWARE MENU REFERENCE
'aSa.- *,a* r,w-..
I 319
• GRS 1980.
• Helmert 1906.
• Hayford.
• Hough.
• Indonesian 1974.
• International 1909.
• International 1967.
• Krassovsky.
• Mercury 1960.
• Modified Airy.
• Modified Everest.
• Modified Mercury 1968.
• South American 1969.
• Southeast Asia.
• Sphere Radius 6370997m.
• WGS 60.
• WGS 66.
• WGS 72.
• WGS84.

F FE ' HJ ENVI/IDL... 3
Allows raw HRPT data to be transformed to a user-defined map projection and exported
as an ENVI/IDL image. The HRPT ENVI/IDL exporter window is displayed. It looks
and works the same as the HRPT PCI Geomatica exporter window (figure 3.11)
described in Fi1eExportHRPTPCI Geomatica....
The projection types supported by the ENVI/IDL exporter are as follows:
• Albers Conical Equal Area.
• Azimuthal Equidistant.
• Equirectangular.
• Gnomonic.
• Hammer.
• Lambert Azimuthal Equal Area.
• Lambert Conformal Conic.
• Mercator.
• Miller Cylindrical.
• Mollweide.
• Orthographic.
• Polar Stereographic.
• Polyconic.
• Robinson.
3-20 DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE

• Sinusoidal (Sanson-Flamsteed).
• Stereographic.
• Van der Grinten.
• Wagner IV.
• WagnerVll.
Only the Sphere Radius 6370997m earth model is supported by the ENVI/IDL exporter
if the following projection types are selected:
• Azimuthal Equidistant.
• Equirectangular.
• Gnomonic.
• Hammer.
• Lambert Azimuthal Equal Area.
• Miller Cylindrical.
• Mollweide.
• Orthographic.
• Robinson.
• Sinusoidal (Sanson-Flamsteed).
• Stereographic.
• Van der Grinten.
• Wagner IV.
• Wagner VII.
For all other supported projection types, the earth models supported by the ENVI/IDL
exporter are as follows:
• Airy.
• Australian National.
• Bessel.
• Bessel 1841 (Namibia).
• Clarke 1866.
• Clarke 1880.
• Everest.
• GRS 1980.
• Helmert 1906.
• Hough.
• International 1909.
• International 1967.
• Krassovsky.
• Mercury 1960.
• Modified Airy.
• Modified Everest.
SOFTWARE MENU REFERENCE i 3-21
-- -.- ..................................... . - . - - - - -

• South American 1969.


• Southeast Asia.
• WGS 60.
• WGS 66.
• WGS 72.
• WGS 84.

-H Ge0TIFF...
Allows raw HRPT data to be transformed to a user-defined map projection and exported
as a GeoTIFF image. The HRPT GeoTIFF exporter window is displayed. It looks and
works the same as the HRPT PCI Geomatica exporter window (figure 3.11) described
in FiIeExportHRPTiPCI Geomatica.
The projection types supported by the GeoTIFF exporter are as follows:
• Albers Conical Equal Area.
• Azimuthal Equidistant.
• Equidistant Conic.
• Equirectangular.
• Gnomonic.
• Lambert Azimuthal Equal Area.
• Lambert Conformal Conic.
• Mercator.
• Miller Cylindrical.
• Orthographic.
• Polar Stereographic.
• Polyconic.
• Robinson.
• Sinusoidal (Sanson-Flamsteed).
• Stereographic.
• Transverse Mercator.
• Van der Grinten.
The earth models supported by the GeoTIFF exporter are as follows:
• Airy.
• Australian National.
• Bessel.
• Bessel 1841 (Namibia).
• Clarke 1866.
• Clarke 1880.
• Everest.
• GRS 1980.
• Helmert 1906.
L 3-22 J DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
- - SC! '- yr.t.ruc C - -.-., r. V - fl. t.. a.arv"

• Indonesian 1974.
• International 1967.
• Krassovsky.
• Modified Airy.
• Modified Everest.
• Sphere Radius 6370997m.
• WGS84.

NOAA level 1 B... 0-n fl


Allows raw HRPT data to be exported in NOAA level lB format. The HRPT NOAA level
lB exporter window (figure 3.12) is displayed.

Figure 3.12
The HRPT NOAA level Path: Caromtpata'fl1RPT [i
1 B exporter window Image: Wed, May 03, 2009 10:11:20 (GMT+ 1:00)

(FileExportHRPT NOAA 17, Southbound, to East, 2964 tnes, charorel 30


Output
NOAA level lB ... ) Version: Version tin us ed for satefl:tes up to and indudfrg N14.
(Sued) Version 2 is used for .M
I3 (VI 15 through NiP) satelOtes.
Version 35 used from N18 onwards

Parting: [Unpacked
Byte order: [Utsie-endian
PIe name: [Onto stamped, GMT

Show overlays

[close I

The current data path is shown in the Path box. Click the Choose... button to change it if
required using the Data path window (similar to that shown in figure 3.3).
The images found in the specified path are listed in the Image drop-list. Select an image
to export from those available. More information about the selected image is shown
below the drop-list and a preview is shown on the right-hand side of the window. Use the
Show overlays tick-box to show or hide the preview's map overlays.
To refresh the list of images to ensure it shows the latest data, click Refresh. To select the
most recent image, click Latest.

Output area
Choose whether the exported data should be stored in packed or unpacked format using
the Packing drop-list.
Select the byte order for the exported data using the Byte order drop-list. If the data will
be used on an Intel x86 or DEC Alpha platform, choose Little-endian. For Sun SPARC or
Motorola platforms, choose Big-endian. In little-endian byte order, the least significant
byte of a word is stored first. In big-endian byte order, the most significant byte of a word
is stored first.
Choose the required file name for the exported data using the File name drop-list. Short
date stamped, GMT and Short date stamped, local time use the date and time of the
pass in the format YYMMDDHH. Date stamped, GMT and Date stamped, local time
use the date and time of the pass in the format YYYY-MM-DD HH-MM. Custom allows a
specific file name to be entered when Export as... is clicked.
SOFTWARE MENU REFERENCE 1 3-23

Exporting the data


When you have configured the output settings according to your requirements, click
Export as..., enter or edit the file name in the Export data as window (similar to that
shown in figure 3.5) and click Save.

1 . i> Other raw format... G,i


Allows raw HRPT data to be exported in various standard and third-party raw formats.
The HRPT raw exporter window (figure 3.13) is displayed.

Figure 3.13 raw exporter

The HRPT raw Path cartom\Data4PPT


exporter window Image; Wed, May 13 2009 1O20GMT+O0) -

(File.Export'HRPT' NOAA 17, Soxthboxrrd, to East, 2964 hoes, charrrrel 39


Output
Other raw format...) Format: Standardraw
Header None . - 1
Byte order [Ulde-esdlan ... •1
File rraoe: [Date stamped, GMT.

(]Show overlays

Export as... j close

The current data path is shown in the Path box. Click the Choose... button to change it if
required using the Data path window (similar to that shown in figure 3.3).
The images found in the specified path are listed in the Image drop-list. Select an image
to export from those available. More information about the selected image is shown
below the drop-list and a preview is shown on the right-hand side of the window. Use the
Show overlays tick-box to show or hide the preview's map overlays.
To refresh the list of images to ensure it shows the latest data, click Refresh. To select the
most recent image, click Latest.

Output area
Choose the required raw format using the Format drop-list. The full range of supported
HRPT raw formats is described in table 3.1.

Table 3 1 n co mposit ion


Supported HRPT raw
data formats Ni e1o. .......]j6frame sync;
RPT 10984 data; 100 auxiliary sync; 6sj
Standard raw,.
LegacyDart Fnraw 23 amiliary 5

HRPT level 0 is the format required by the SeaShark processing software, set out in the
SeaShark Detailed Design Document, section 5.1.1. Standard raw is the complete HRPT
frame, including all frame sync and auxiliary sync words. Legacy Dartcom raw is the
format used by the Dartcom HRPT/CHRPT Grabber software.
Select the required header file to accompany the raw data using the Header drop-list. If a
header file is not required, choose None.
If the raw data is to be used with the SeaShark processing software, choose SeaShark.
This will create a file named AQTIM.DAT containing the satellite number, start date, start
time, end date, end time and total number of frames for its associated image.
L324'DTCOMDA P / M ACROPRO SOFTWARE USER GUIDE

If the raw data is to be used with the CRISP processing software, choose CRISP. This will
append three pseudo-frames to the raw file. The first contains the NORAD two-line ele-
ments in ASCII format, with a line feed character separating the lines. The second con-
tains the start time in standard UNIX timestamp format (seconds since midnight on 1st
January 1970 as a 32-bit long integer). The third contains the resynchronisation time in
UNIX format. In all three pseudo-frames, unused bytes are filled with zero.
Select the byte order for the raw data using the Byte order drop-list. If the data will be
used on an Intel x86 or DEC Alpha platform, choose Little-endian. For Sun SPARC or
Motorola platforms, choose Big-endian. In little-endian byte order, the least significant
byte of a word is stored first. In big-endian byte order, the most significant byte of a word
is stored first.
Choose the required file name for the exported data using the File name drop-list. Date
stamped, GMT and Date stamped, local time use the date and time of the pass in the
format YYYY-MM-DD HH-MM. Short date stamped, GMT and Short date stamped,
local time use the date and time of the pass in the format YYMMDDHH. Custom allows
a specific file name to be entered when Export as... is clicked.

Exporting the data


When you have configured the output settings according to your requirements, click
Export as..., enter or edit the file name in the Export data as window (similar to that
shown in figure 3.5) and click Save.

jI AnciIIarydata...3G-n
Allows ancillary data stored within an HRPT image or its associated data files to be
exported to various formats. The HRPT ancillary data exporter window (figure 3.14) is
displayed.

Figure 3.14 EPT ancillary data exporter - - - - - - -

The HRPT ancillary Path: Cartcomata'4P.PT


data exporter window 10909: Wed, May 13, 2009 10:11:20 (GMT+1:O0) [t
(FileExportHRPT N000 17, Southbound, to East, 2964 hoes, channel 30
Output -
4

Ancillary data...) Data: [two.4oeelments 1


He rsanse: stamped, GMT

Show overlays

Exportas.. Close

The current data path is shown in the Path box. Click the Choose... button to change it if
required using the Data path window (similar to that shown in figure 3.3).
The images found in the specified path are listed in the Image drop-list. Select an image
to export from those available. More information about the selected image is shown
below the drop-list and a preview is shown on the right-hand side of the window. Use the
Show overlays tick-box to show or hide the preview's map overlays.
To refresh the list of images to ensure it shows the latest data, click Refresh. To select the
most recent image, click Latest.
SOFTWARE MENU REFERENCE 3-25

Output area
Select the type of data to output using the Data drop-list. The range available includes
NORAD two-line elements, TBUS messages, DCS, TIP and legacy ancillary data file
formats used by the Dartcom HRPT/CHRPT Grabber software.
Choose the required file name for the exported data using the File name drop-list. Date
stamped, GMT and Date stamped, local time use the date and time of the pass in the
format YYYY-MM-DD HH-MM. Custom allows a specific file name to be entered when
Export as... is clicked.

Exporting the data


When you have configured the output settings according to your requirements, click
Export as..., enter or edit the file name in the Export data as window (similar to that
shown in figure 3.5) and click Save.

CHRPT sub-menu G-nfl


Allows raw CHRPT data to be exported in various formats, including PCI Geomatica,
ERDAS IMAGINE, ENVI/IDL and GeoTIFE

E1 [ .... PCI Geomatica... S 0-n fl


- Allows raw CHRPT data to be transformed to a user-defined map projection and exported
as a PCI Geomatica image. This function works the same as FiIeExportHRPTPCI
Geomatica.

1 JEi ERDAS IMAGINE... B G-n


Allows raw CHRPT data to be transformed to a user-defined map projection and exported
as an ERDAS IMAGINE image. This function works the same as FileExportHRPT
ERDAS IMAGINE....

ENVI/IDL... G-n
Allows raw CHRPT data to be transformed to a user-defined map projection and exported
as an ENVI/IDL image. This function works the same as File ExportHRPT
ENVI/IDL.

i[E[çJ GeoTIFF...G-nfl
Allows raw CHRPT data to be transformed to a user-defined map projection and exported
as a GeoTIFF image. This function works the same as File Expor9HRPT.
GeoTIFF.

r] rEl r Other raw format... E3 I-ri


-
Allows raw CHRPT data to be exported in various standard and third-party raw formats.
This function works the same as FileExportHRPThOther raw format....
The full range of supported CHRPT raw formats is described in table 3.2.

Table
ae. 3.2 at e composition words
Supported CHRPT raw
data formats L t L
- 1
frae
rn sync; 22074 data;i 00uxWary sync
egacyDartcomrawframesynç22074data
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

T >[E1> rdl Ancillary data... ER 3-n


Allows ancillary data stored within a CHRPT image or its associated data files to be
exported to various formats. This function works the same as File Export.HRPT
Ancillary data....

> [El 3 SeaWiFS sub-menu 3-n


Allows raw SeaWiFS data to be exported in various formats, including PCI Geomatica,
ERDAS IMAGINE, ENVI/IDL, GeoTIFF and SeaWiFS level 0.

PCI Geomatica... 0 . 0-n


Allows raw SeaWiFS data to be transformed to a user-defined map projection and
exported as a PCI Geomatica image. This function works the same as Filel"Exporto.
HRPTPCI Geomatica.

ERDASIMAGINE... 0 3-nfl
Allows raw SeaWiFS data to be transformed to a user-defined map projection and
exported as an ERDAS IMAGINE image. This function works the same as Filem-Exporto.
HRPTERDAS IMAGINE....

'il HE1 l ENVI/IDL... 08...,,


Allows raw SeaWiFS data to be transformed to a user-defined map projection and
exported as an ENVI/IDL image. This function works the same as Fi1eExport'
HRPTENVI/IDL.

GeoTIFF... 0 3-nfl
Allows raw SeaWiFS data to be transformed to a user-defined map projection and
exported as a GeoTIFF image. This function works the same as FileeExportP.HRPT
GeoTIFF....

> rE 31 SeaWiFS level 0... 3-n fi


- Allows raw SeaWiFS data to be exported to the standard SeaWiFS level 0 format used by
the SeaDAS processing software. The SeaWiFS level 0 exporter window (figure 3.15) is
displayed.

Figure 3.15 SeaWiFS level O''

The Sea WiFS level 0 Path: C:'partcom\eta'eaW:Fs [choose...] [] rii i


exporter window ImaQer ThsMar2OO9t42(GMT+OOC)]t
SeaStar, Southbound, to East, 4151 fines
(FileExportSeaWiFS.
Output
SeaWiFS level 0...) Fie rave: [Standard, GMT (YMMDD5Q1100) - -]

Mt Show overlays

Exporlas...]

The current data path is shown in the Path box. Click the Choose... button to change it if
required using the Data path window (similar to that shown in figure 3.3).
The images found in the specified path are listed in the Image drop-list. Select an image
to export from those available. More information about the selected image is shown
SOFTWARE MENU REFERENCE •3727
- ,flnpJa,flne, 4te,fl .- rnn

below the drop-list and a preview is shown on the right-hand side of the window. Use the
Show overlays tick-box to show or hide the preview's map overlays.
To refresh the list of images to ensure it shows the latest data, click Refresh. To select the
most recent image, click Latest.

Output area
Choose the required file name for the exported data using the File name drop-list.
Standard, GMT and Standard, local time use the date and time of the pass in the format
YYMMDDHHMM. Custom allows a specific file name to be entered when Export as... is
clicked.

Exporting the data


When you have configured the output settings according to your requirements, click
Export as..., enter or edit the file name in the Export data as window (similar to that
shown in figure 3.5) and click Save.

E -^1 Ancillary data... BE G—n


fl
Allows ancillary data stored within a SeaWiFS image or its associated data files to be
exported to various formats. This function works the same as File * Export o HRPT O.
Ancillary data....

[f[ AHRPT sub-menu G-n fl


Allows raw AHRPT data to be exported in various formats, including PCI Geomatica,
ERDAS IMAGINE, ENVI/IDL and GeoTIFE

ji PCI Geomatica... B S-n


Allows raw AHRPT data to be transformed to a user-defined map projection and exported
as a PCI Geomatica image. This function works the same as FileExporDHRPT
PCI Geomatica....

-A : ERDAS IMAGINE... S .—
Allows raw AHRPT data to be transformed to a user-defined map projection and exported
as an ERDAS IMAGINE image. This function works the same as Fi1eExportHRPT
ERDAS IMAGINE....

ENVI /IDL... S S-ri fl


Allows raw AHRPT data to be transformed to a user-defined map projection and exported
as an ENVI/IDL image. This function works the same as File Export.HRPT
ENVI/IDL.

GeoTIFF... ER S-nfl
Allows raw AHRPT data to be transformed to a user-defined map projection and exported
as a GeoTIFF image. This function works the same as FileExportHRPTGeoTIFF.
328 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

F[J>[. DMSP sub-menu G-ii


Allows raw DMSP data to be exported in various formats, including PCI Geomatica,
ERDAS IMAGINE, ENVI/IDL and GeoTIFE

PCI Geomatica... S 0-n fl


-- Allows raw DMSP data to be transformed to a user-defined map projection and exported
as a PCI Geomatica image. This function works the same as Fileo-Exporto-HRPT0.
PCI Geomatica....

, ERDAS IMAGINE... ES 0-n fl


- Allows raw DMSP data to be transformed to a user-defined map projection and exported
as an ERDAS IMAGINE image. This function works the same as Fileo-Exporto-HRI'To.
ERDAS IMAGINE....

ENVI/IDL... S 0-ri fl
Allows raw DMSP data to be transformed to a user-defined map projection and exported
as an ENVI/IDL image. This function works the same as File.ExportHRPT.
ENVI/IDL.

jr GeoTIFF...G-nfl
- Allows raw DMSP data to be transformed to a user-defined map projection and exported
as a GeoTIFF image. This function works the same as Fi1eExportHRPTGeoTIFF.

.- 7m1 MSG LRIT/HRIT sub-menu E3 Gm ...
Allows raw MSG LRIT/HRIT data to be exported in various formats, including PCI
Geomatica, ERDAS IMAGINE, ENVI/IDL and GeoTIFF.

[Elj PCI Geomatica... S 0-n


Allows archived MSG LRIT/HRIT image data to be transformed to a user-defined map
projection and exported as a PCI Geomatica image. The MSG LRIT/HRIT PCI
Geomatica exporter window (figure 3.16) is displayed.
SOFTWARE MENU REFERENCE 3-29
• fl ys,W .,fl. v-%a
cafl.- .u ,. ,a-u ;fl

Figure 3.16 MStD LRIT/HPJT PCI Geomatica e.xorter

The MSG LRIT/HRIT PCI Path: CartcomDat(RITWdlve

Geomatica exporter Trifle: o MSC-2


B 000511
window (0120(1
(FileExportMSG B 05 (May)
] 03
LRlT/HRlTPCI 20 000513
04

Geomatica ... ) 20 2011


B 05 (may)
1=103 _________

15:00:00 (GMT)
10:000(5)
2 (:00:00 (GRiT)
0004
B MTP
lOOT?
MOOD, GOES 13 -Tue May 3, 2011 (P 12:00:00 (GMT) R]Show overlays
Export settings Map option
Products: Preview product: [03_9_975w
]
[ourope Eqiarectangular V.
E.
RJ 00j_075W Data 1
R 03_9_075W
RI Raw
RI 06_6_075vi
RI 10_7_075W RI Calibrated
RI Additional data
Summary: Raw data, Cathrated data, Solar zenith
and azimuth

RI Show overlays

0 00y Emyr( on [Close J

The current data path is shown in the Path box. Click the Choose... button to change it if
required using the Data path window (similar to that shown in figure 3.3).

The data path must contain decrypted, decompressed image segments. If the
// archive is large it may take sometime for iDAP to analyse it.

The image times found in the specified path are listed in the Time box, organised by
service, satellite, year, month, day and time. Select a time to export from those available.
A preview is shown on the right-hand side of the window. Use the Show overlays tick-
box to show or hide the preview's map overlays. Move the mouse over the preview to
obtain latitude and longitude read-outs.
To refresh the list of image times to ensure it shows the latest data, click Refresh.

Export settings area


The Products list shows the image products available for the selected time. Choose the
products to include in the exported image using the tick-boxes.
Select the image product to use when generating the preview of the transformed image
from those available in the Preview product drop-list.
Use the Data tick-boxes to choose what types of data to include. Raw exports the raw
pixel values at full data resolution for each product. Calibrated exports the calibrated
data values for each product. Additional data exports the solar zenith and azimuth
angles for each pixel. A summary of the data that will be exported is shown under the
tick-boxes.
1 3-30 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

Map option area


Choose the required map option from those available in the drop-list. A preview of the
area covered is shown below the drop-list. Use the Show overlays tick-box to show or
hide the preview's map overlays. Move the mouse over the preview to obtain latitude and
longitude read-outs. Use the and buttons to change the magnification of the
preview. Note that this does not affect the size or magnification of the exported image.
To edit or delete the selected map option or add a new one, click Edit.... The Map
options manager window (figure 3.36) is displayed. Use it to edit, delete or add map
options as required, then select the required map option and click Close. See
Navigation-Map options... for more information.
See FileExportHRPTPCI Geomatica... for details of the projection types and earth
models supported by the PCI Geomatica exporter.

Exporting the image


When you have configured the export settings according to your requirements, click
Create preview. This calculates transformation matrices and creates a preview of the
exported image in the Map option area. If the map overlay does not align correctly with
the preview, use the 0. button in the Map option area to increase the magnification of
the preview and click Nudge overlays. Drag the overlays so they align with the image,
then click Nudge overlays again.

The exported image is nudged to fit the overlay rather than the overlay being
'—J"1 nudged to fit the image. This ensures that the exported area matches that
defined by the map option. Do not worry that this is contradicted by the
image preview.

If the image preview looks satisfactory, click Export as... to export it to a PCI Geomatica
file. The Export image as window (similar to that shown in figure 3.5) is displayed.
Enter a name for the exported file and click Save to begin the export process.

[>E>rW ERDASIMAGINE...G-n
Allows archived MSG LRIT/HRIT image data to be transformed to a user-defined map
projection and exported as an ERDAS IMAGINE image. The MSG LRIT/HRIT ERDAS
IMAGINE exporter window is displayed. It looks and works the same as the MSG
LRIT/HRIT PCI Geomatica exporter window (figure 3.16) described in FileExport
MSG LRIT/HRITPCI Geomatica.
See FileExportHRPTERDAS IMAGINE... for details of the projection types and
earth models supported by the ERDAS IMAGINE exporter.

ENVI/IDL...
Allows archived MSG LRIT/HRIT image data to be transformed to a user-defined map
projection and exported as an ENVI/IDL image. The MSG LRIT/HRIT ENVI/IDL
exporter window is displayed. It looks and works the same as the MSG LRIT/HRIT PCI
Geomatica exporter window (figure 3.16) described in FileExportMSG
LRIT/HRITh.PCI Geomatica....
See Fi1eExpor0HRPTENVI/IDL... for details of the projection types and earth
models supported by the ENVI/IDL exporter.
SOFTWARE MENU REFERENCE r3-3.i]

GeoTIFF... I-nfl
Allows archived MSG LRIT/HRIT image data to be transformed to a user-defined map
projection and exported as a GeoTIFF image. The MSG LRIT/HRIT GeoTIFF exporter
window is displayed. It looks and works the same as the MSG LRIT/HRIT PCI
Geomatica exporter window (figure 3.16) described in FileExportMSG
LRIT/HRITPCI Geomatica.
See Fi1eExportHRPTGeoTIFF... for details of the projection types and earth models
supported by the GeoTIFF exporter.

GOES LRIT sub-menu 0 1-n fl


Allows archived GOES LRIT data to be exported in various formats, including PCI
Geomatica, ERDAS IMAGINE, ENVI/IDL and GeoTIFF.

[1EJij PClGeomatica... B I-nfl


Allows archived GOES LRIT image data to be transformed to a user-defined map projec-
tion and exported as a PCI Geomatica image. This function works the same as File
ExportMSG LRIT/HRITPCI Geomatica.

[El I ERDAS IMAGINE... E3 I


-" fl
Allows archived GOES LRIT image data to be transformed to a user-defined map projec-
tion and exported as an ERDAS IMAGINE image. This function works the same as Fi1e
ExportMSG LRIT/HRITERDAS IMAGINE....

!Ft> E r ENVI/IDL... G 0-n fi


Allows archived GOES LRIT image data to be transformed to a user-defined map projec-
tion and exported as an ENVI/IDL image. This function works the same as Fileo.
ExportMSG LRIT/HRIT.ENVI/IDL.

GeoTIFF... S G-nfl
Allows archived GOES LRIT image data to be transformed to a user-defined map projec-
tion and exported as a GeoTIFF image. This function works the same as Fi1eExport
MSG LRIT/HRITGeoTIFF....

[1 EE1 MTSAT LRIT/HRIT sub-menu 1-n fl


Allows archived MTSAT LRIT/HRIT data to be exported in various formats, including PCI
Geomatica, ERDAS IMAGINE, ENVI/IDL and GeoTIFF.

PCI Geomatica... EB 0-n fl


Allows archived MTSAT LRIT/HRIT image data to be transformed to a user-defined map
projection and exported as a PCI Geomatica image. This function works the same as
'
Filem ExportiMSG LRIT/HRITPCI Geomatica.

11 IEJ [fI ERDAS IMAGINE... E3 0-n fi


Allows archived MTSAT LRIT/HRIT image data to be transformed to a user-defined map
projection and exported as an ERDAS IMAGINE image. This function works the same as
Fi1eExporDMSG LRIT/HRITERDAS IMAGINE....
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

Ur ENVI/IDL... GO G-n
Allows archived MTSAT LRIT/HRIT image data to be transformed to a user-defined map
projection and exported as an ENVI/IDL image. This function works the same as File
ExportMSG LRIT/HRITENVI/IDL....

GeoTIFF... E3 0-n fl
Allows archived MTSAT LRIT/HRIT image data to be transformed to a user-defined map
projection and exported as a GeoTIFF image. This function works the same as File.
ExportiMSG LRIT/HRITGeoTIFF.

Print...G-n
[
Allows the active image or fax document to be printed. The Print options window
(figure 3.17) is displayed.

Figure 3.17
The Print options
window (File'Print ... )

Area area
This area allows the area of the image to print to be chosen. To print the whole image,
switch on the Whole image tick-box. To print an area of the image, switch off Whole
image and, using the left mouse button, draw a box on the image preview around the area
you want to print. The box can be resized by dragging the mouse over its edges and
moved by dragging the mouse inside its edges. The position and size of the box is shown
below the Whole image tick-box.

Options area
This area allows various optional items to be switched on or off. The Title tick-box con-
trols inclusion of the file name and image details at the top of the page. The Information
tick-box controls inclusion of the image's additional information text (displayed in the
text area of its document window below the date and time) at the bottom of the page.

For GVAR images you may want to switch off the Information tick-box, as the
40A additional information for these types of image can be lengthy. -
SOFTWARE MENU REFERENCE 3-33

The remaining tick-boxes will only be available if the document is a navigated image.
Maps and grids controls inclusion of the map overlays and grid lines configured for the
document. Station position controls inclusion of the station position indicator.
Reference points controls inclusion of the currently enabled reference points (see
Navigation-Reference points...). Lat/lon legends controls inclusion of latitude and
longitude labels at the edges of the image. If Lat/lon legends is ticked, choose the fre-
quency of the labels (in degrees) using the Frequency drop-list.

Prints of images which have a formula palette (see Processing-Formula


't— " palette...) will only include the palette's key (see View . Palette key...) if the
Information tick-box is switched on.

Printing the image


After choosing the area to print and configuring the options as required, click OK to print
the image. The Print window (figure 3.18) is then displayed.

Figure 3.18
Printer
The Print window
Name: [PLaserJet2300 Series PCI. 5 - [ Properties...
Status Ready
Ipys HP LaserJet 2300 Series PCL 5
Where: 192,16S 0,22
Comment: j Pant to He

Print range Copies



triJI Number of copies: 1
Pages
2 ,
110


Help [ OK J[cancet I

Check that the required printer is selected and configured correctly and change the
number of copies if required. Click OK to print the document on the chosen printer.

Print setup... ER G-n


Allows the printer to be configured. The Print Setup window (figure 3.19) is displayed.

Figure 3.19 ;t Setup m---:-_

Printer
The Print Setup
window (FilePrint Name: [! lazerJet 2300 SerIes PCL5 ..] [ Properties..,
Status Ready
setup...) Type: HP LssrJet 2300 Series PCL 5
Where: 192.168.022
Comment.

Paper Orientation
One: k4 - - - H @ Portrait
Source' [Artomaticaity Select l
. ) Landscape

HeIp ,[vRk.j [,ox_ [ Cancel

Choose a printer to use from the Name drop-list in the Printer area. To change the set-
tings for the selected printer, click Properties. In the Paper area, choose the size of paper
in your printer, and the source tray of the chosen paper size. Choose whether to print in
portrait or landscape format from the Orientation area.
3- 'AA DARTCOM1DAP/MACROPRO SOFTWARE USER GUIDE
- - --

1 Exit G-'i
Closes the software. For each document which has been changed but not yet saved, a
window is displayed asking if it should be saved before the software is closed.

Neither MAP nor MacroPro can be closed if locked. The software must first be
unlocked by using UtilitiesSecurity... and entering the correct password.
SOFTWARE MENU REFERENCE 3-35
S -
- - S . .\ S - SSfl flS - S -. -

Edit menu
The Edit menu provides functions undoing and redoing previous operations, and for
cutting, copying and pasting data to and from the Windows clipboard. Functions in this
menu are only available for selection when it is possible to use them.

[El Undo
Reverses the effects of the previous operation, restoring the state before the operation was
carried out. Only available for animation documents.

: Redo
Reapplies the effects of the previously undone operation. Only available for animation
documents.

Cuts
Moves the selected data on to the clipboard, removing it from its current position.

El Copy
I Puts a copy of the selected data on the clipboard, without removing the data from its
current position.

•E Paste-
Pastes a copy of the data on the clipboard into the selected object.
L!:iI DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
t*r ..*

Fvi View menu


0
0a• .......,. a.,a................... S a a a a a • a S S a S S a S S S 5*5* 55SS S S ........ . .... • S * * S S I

The View menu provides functions for switching between the various viewing modes,
showing the palette key for images with a formula palette, switching on and off drawing of
the station position, reference points and overlays on image documents, showing and
hiding the tool bar, status bar and panels, and restoring the original, unprocessed data in
image documents.

IN YJ
5 Pan and scroll mode
Switches on or off pan and scroll mode. When switched on, the view of the active docu-
ment can be panned and scrolled by moving the mouse over the document window, then
holding the left mouse button down (to grab hold of the image) whilst dragging the
mouse in any direction. Release the left mouse button when you want to stop panning
and scrolling the view.

iTj] Magnification mode


- Switches on or off magnification mode. When switched on, the view of the active docu-
ment can be magnified and reduced using the left and right mouse buttons respectively.
To magnify the view, click the left mouse button on the point to use as the zoom centre.
To reduce the magnification of the view of a document, click the right mouse button on
the image area. The current level of magnification is shown in the read-outs panel on the
right-hand side of the MAP application window.
View-Set magnification... can also be used to set the magnification to a specific level.

j1 Set magnification...
Allows the magnification of the active document to be set to a specific level. This func-
tion is not available for animation documents. The Set magnification window (figure
3.20) is displayed.

Figure 3.20 Set m^g^KTIG, p


The Set magnification New naQnisicaboa [i: 1 (actual size)
window (Viewi. Cancel jf OK

Set magnification...)

Choose the new magnification level from the New magnification drop-list, then click OK
to apply it to the active image.

;. ['tf Palette key...


Displays the formula palette key for the active image document. This function is not
available for fax or animation documents, or for image documents which do not have a
formula palette. See Processing-Formula palette... for information on creating and
applying formula palettes. The Key window (figure 3.21) is displayed.
SOFTWARE MENU REFERENCE 1 3-37
a S..._Liflras .. a&' ' tra -- - . -c .. 4*S..fl.X ',-t •!_U.P.1

Figure 3.21
The Key window ond height

(ViewPaIette key...)
Units: ft x100
fl] 10.00

U 12.00
14.00
15.00
18.00
20.00
22,00
24,00
25.00
28.00
30.00
32.00
ri 34,00
35.00
38.00
40,00
42.00

This window is a floating window, which means it can be moved anywhere on the screen
and stays on top of all other windows, and you can click another image document window
at any time to show its formula palette key (if it has a formula palette).
The box at the top of the window shows the name of the formula which was used to gener-
ate the palette. Click Formula... to view the actual formula in a pop-up window. The
units in which the formula results are measured are shown below the Formula button.
To view the palette key of another image document, click the mouse in its window. The
Key window then changes to show the document's formula palette.

Station position
Enables or disables drawing of a marker indicating the current ground station position on
all navigated image documents. The station position marker appears as an orange dot. A
title is displayed above the marker if switched on (see NavigationReference points...).
Not available when a fax or animation document is active.

U i1 Reference points
Enables or disables drawing of markers indicating the positions of the currently enabled
reference points (see NavigationReference points...) on all navigated image docu-
ments. Reference point markers appear as white dots. Not available when a fax or ani-
mation document is active.

Overlays
Enables or disables drawing of map overlays on navigated image documents. Not avail-
able when a fax or animation document is active.

[fj Lat/lon legends


Enables or disables drawing of grid line legends (labels) at the edges of navigated image
documents. Not available when a fax or animation document is active.

Toolbar
Shows or hides the tool bar, which contains shortcut buttons for commonly used func-
tions (see section 2). The tool bar can be docked to the top, bottom, left or right edge of
the iDAP or MacroPro application window, or floated on top of all other windows.

[ j] Read-outs panel
Shows or hides the read-outs panel, which displays data read-outs corresponding to the
image pixel under the mouse cursor (see section 2). The panel can be docked to the left
or right edge of the iDAP application window, or floated on top of all other windows.
DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE

[J Acquisition status panel


Shows or hides the acquisition status panel, which displays the status of any image
capture systems which are known to MAP. The status is updated once per minute. The
panel can be docked to the left or right edge of the MAP application window, or floated on
top of all other windows.

Status bar
Shows or hides the status bar displayed at the bottom of the MAP or MacroPro application
window (see section 2).

RJ
- Restore from original data
Restores the view of the active image to show the original, unprocessed image data, as it
was ingested, and resets the enhancement settings to defaults. Not available when a fax or
animation document is active.
- SOFTWARE MENU REFERENCE 1 339
-

; lull • ,.*..,..a.e.. *0t,.-.- ron 0 soar,.. *a..,s00000 a a * a 0• S Sötø

The Processing menu provides a range of image processing functions, including image
enhancement, formula palettes, rotating, flipping, sharpening, blurring and edge enhance-
ment. It is only available when an image or fax document window is active.

fp1 Enhance...
Allows the active image document to be enhanced to improve its appearance or to high-
light particular features. The Enhance window (figure 3.22) is displayed.

Figure 3.22 - -- --- - - plane


The Enhance window -- Enhancement and histogram for red plane [j) []
(Processingo. F
1
LI loverS profile
Enhance...) / I plrow histogram on graph
Enhancement profile

cj f tfinorao "I
EE Show profile on graph

Preset

•-0
1S.v1 1inte1
U---------------- Co Alyoutomeficolly

------U----- -------- +o L°i-[U

This window is a floating window, which means it can be moved anywhere on the screen
and stays on top of all other windows, and you can click another image document window
at any time to show or modify its enhancement settings (if it can be enhanced).
The graph area shows the histogram for the currently-selected image plane and the
enhancement profile applied to that plane (the black line). The histogram shows the fre-
quency of occurrence of each of the 256 possible pixel values. Move the mouse cursor
over the graph to show the pixel values at points on the graph in the pixel value read-out
('h) at the top of the window.
The three sliders allow the enhancement profile for the currently-selected image plane to
be adjusted in three different ways. The vertical slider (*) adjusts the brightness, the
upper horizontal slider () adjusts the contrast and the lower horizontal slider (4) adjusts
the horizontal offset (the point on which the profile is centred horizontally). As a slider is
dragged, its value is shown next to the symbol and its effect on the enhancement profile
can be seen instantly on the graph. Increasing the brightness moves the enhancement
profile upwards. Decreasing it moves the profile downwards. Increasing the contrast
squashes the profile horizontally, centred on the horizontal offset. Decreasing it stretches
(or flattens) the profile. Increasing the horizontal offset moves the profile to the right.
Decreasing it moves it to the left.
To apply the current enhancement settings to the active image, click Apply. To revert to
the previous settings, click Revert. To reset the sliders and Invert profile tick-box to
defaults, click Reset. If you want adjustments to the enhancement settings to be applied
to the active image immediately, switch on the Apply automatically tick-box.

To see the effects on the image of changes to the enhancement settings, you
t.JIfJ must either click Apply, or switch on the Apply automatically tick-box.
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

Plane area
Use the Red, Green and Blue buttons to display the histogram and enhancement profile
for the corresponding image plane on the graph and allow adjustment of the enhance-
ment settings for that plane. These buttons are only available for 24-bit (multi-plane)
images. If the active image is 8-bit (single-plane), they will be disabled.
The Invert profile tick-box specifies whether or not the enhancement profile for the cur-
rently-selected plane should be inverted vertically. The Show histogram on graph tick-
box specifies whether or not the histogram for the currently-selected plane is displayed on
the graph.

Enhancement profile area


The drop-list allows the type of profile to use as a basis for enhancement of all planes in
the image to be chosen. The different types of profile and their effects on an image
(without any further adjustments) are described in table 3.3.

Table 3.3 Effect on' imáge


Profile
Types of enhancement
profile, their shapes and Linear Straight line (y=x) covering all 1
, No enhancement (pixel
their effects on images pixel values válüesàsihgèsted)
Mm-max Straight line rising between the Applies a linear enhancement
minimum and maximum pixel
values of the -hi stogram
0
to pixel values present in the
image only
T
_q
Histogram Profile which reflects the shape TApplies optimum levels to
equalisation, of the histogram taking into il pixel values present in the
j account peaks in pixé! value I image only
applied between theminimum I Gaussian distribution to pixel
and maximum pixel values values present in the image
L necurve between the minimum Applies low valueiased levels
F.andonly
maximum pixel values to pixel values present in the
Hmage only
1 C6sine Vrtically-inverted cosine curve - Applies high value biased
between the minimum and levels to pixel values present in
maximum pixel values I the:irnage only
it

Although the chosen profile type applies to all planes in the image, its actual shape will
probably differ for each plane according to its histogram. The profile can be also adjusted
individually for each plane using the brightness, contrast and horizontal offset sliders
around the graph and the Invert profile tick-box in the Plane area.
The Show profile on graph tick-box specifies whether or not the enhancement profile is
displayed on the graph.

Preset area
This area allows frequently-used enhancement settings to be stored and retrieved quickly
and easily as a preset. The enhancement settings consist of the type of enhancement
profile for all planes, and the settings of the brightness, contrast and horizontal sliders and
Invert profile tick-box for each plane.
SOFTWARE MENU REFERENCE 3-41
* .

To load an existing preset, choose its name in the drop-list, then click Load. To save the
current enhancement settings as a preset, enter a name (or choose an existing name) in
the drop-list, then click Save. To delete an existing preset, choose its name in the drop-
list, then click Delete.

Tp] Formula paIette...FG-n


Allows a formula palette to be defined and applied to an image to produce products such
as density slicing, brilliance temperatures, sea surface temperatures (SST) and vegetation
indexing (NDVI).

Appendix B of this user guide gives information on formula programming,


I
and describes the complete range of functions which are available.

The Formula palette window (figure 3.23) is displayed.

Figure 3.23
Settings Palette
The Formula palette Preset:
1.. n Use this colour for values smaller than fast
window Cloud height Na x
(Processing Formula Palette type: ()Range of values
palette...) Size:
© Classification
Start: Step:
n

17 5.00 pactiJ

Precision: i?J Whole numbers


© S desinsal place
t 2 dedmal places
© 3 decimal places
[] Graduated colour blending
Formula:
HUT band 4dOud height

* Assume rninmunr ground temperature


Lu
AGTEteP-15.0
'Take factor for loss per Ion height 0.
LPACT=6.t
Work Out dood tap height in km
km=(ASTEMP-cahb(4))FuCT

Formula is valid and can be applied to image.


units: 0 irl
[]

Colours

-:

L'-
[$j
Colour: pg mode: [glel_Graduated !iuse ASs colour for values larger than lost
01 181_uij

[iT as Open last saved document when window Is dosed [_cj

Settings area
This area allows the settings used to generated the formula palette to be configured.
Choose an existing formula palette to use from those available in the Preset drop-list. If
you make any changes to the chosen palette's settings (size, start, step, formula or palette
colours), click the Q button to save them. To save the current settings as a new palette
preset, type the required name in the Preset box, then click I. To delete a preset from
the list, click the X button.
The selected preset's settings are displayed below the Preset drop-list. Choose the type of
palette using the Palette type radio buttons. Range of values creates a product which
corresponds colours to numerical values. Classification corresponds colours to values
and textual labels which can be edited.
3-42j DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE
- SLt4fl S t. - .0

If the Range of values palette type is selected, enter the required number of colours in
the Size box. Enter the value to be assigned to the first palette colour in the Start box.
Enter the increment between successive palette values in the Step box. Click Apply to
palette to apply the new settings to the palette.

To determine the range of the currently selected formula's result, click


'-1" Calculate range (below the formula box). This enables you to set the palette
size, start and step values to fit the result's range.

Select the required number precision using the Precision radio buttons. If you want the
boundaries between colours on the product to be graduated smoothly, switch on
Graduated colour blending. Switch it off if you would prefer more definite boundaries
with no graduation.
If the Classification palette type is selected, the Formula palette window changes as
shown in figure 3.24.

Figure 3.24
Settings Palette
The Formula palette Preset: use this colour for values smaller than first
window configured for a Cloud height
Class 3
S Class 2
classification product Palette type: C) Range of values 11 Class 3
co, Classification 14 Class 4
See: Start: Step: 17 Class5
class 6

Preosion:
[IIJ[IWhnle numbers
[Apply iopj
20
23
26
29
Class?
Class S
Class 9
1 deonrul place 32 Class 10
2 deonral aces 35 Clots 11
30 Class 12
3d places
41 Class 13
0 Graduated colour blending 44 Class 14
Formula: 47 Class 15
50 Class 16
tltsPT band 4 cloud height QX 53 Class 17

Assume minmum ground temperature


AGTEMPSS.0
Take factor for loss per Ion height
LPACT6.S Lu
Work out doud top height in Ion
Ion(AGTEMP-calib(4))fLFACT

Formi.da is valid and can be applied to image.


Units: ft 01000 [] cuivulate rur.1

Colours

Colour *11 pg mode: r1- Gruduutnd Use this colour for values larger than last [ ctecs values


Appdy veJ Open last saved document o4wn wisdom is dosed [_ctuse_J

Enter the required number of palette colours in the Size box and click Apply to palette.

To determine the range of the currently selected formula's result, click


-J"! Calculate range (below the formula box). This enables you to set the palette
size and values to fit the result's range.

For both palette types, choose the formula preset to use to generate the palette from those
available in the Formula drop-list. If you make any changes to the chosen formula or its
units, click the 90 button to save them. To save the current formula as a new formula
preset, type the required name in the Formula box, then click 9. To delete a formula
preset from the list, click the X button.
SOFTWARE MENU REFERENCE [-3-43-1

The selected formula and its status are displayed below the Formula drop-list. The
formula can be edited and new ones created if required. After editing a formula ) click
Check to check its validity.

Do not edit the preset formulae unless you know what you are doing. An
A incorrect formula will produce incorrect results.

Appendix B of this user guide gives information on formula programming and


/ describes the complete range of functions which are available.

The formula palette can only be applied to the image if the formula is valid and the char-
acteristics of the image match or exceed those required by the formula. If the formula is
invalid or cannot be applied to the image, click Check to see the reasons why.
Enter the units in which the results of the formula are measured in the Units box. They
are for display purposes only and do not automatically relate to the formula's actual units.
To check the validity of a formula and its compatibility with the image, click Check. To
determine the range of a formula's result, click Calculate range. This can be used to set
the size, start and step values according to the range of the result.

Palette area
This area displays the palette colours and their corresponding formula result values.
Values outside the range of the palette can be masked out of the product using the colours
at either end of the palette. Configure the colours and set the states of the Use this colour
for values smaller than first and Use this colour for values larger than last tick-boxes
accordingly.
If the Classification palette type is selected, the values and corresponding labels in the
Palette table on the right-hand side can be edited. To edit a value or label, click the
required row in the table, then click once in the appropriate column. After editing a value
or label, press the Enter key. When you have finished editing the table, click Check
values to validate your entered values.

The values for a classification product must be listed in ascending order and
/ adjacent values cannot be the same.

Colours area
This area allows the formula palette's colours to be changed. To select a colour to use,
move the mouse over the grid of colours (noting that the colour under the mouse is dis-
played in the right-hand square of the Colour box) and click the required colour. The
selected colour is then displayed in the left-hand square of the Colour box.
The Fill mode buttons control how palette colours are assigned. In Single mode simply
click a palette entry in the Palette area to assign the selected colour to it, then select
another colour and click another palette entry, and so on, until the palette colours are con-
figured as required.
Graduated mode provides a quick way to set up a palette graduated between several key
colours (red, orange, yellow and green, for example). You simply assign the key colours at
the required palette entries and the intervening entries are automatically filled with grad-
uated colours between them.
To create a palette in Graduated mode:
E-441 DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE

o Select the required start colour in the Colours area (red, for example) and
click the first palette entry in the Palette area to assign the selected colour to
it. A box will appear on that palette entry showing that it will be used as the
start colour for the graduated fill.
O Select the next colour (orange, for example) and click the palette entry you
want to assign it to. The entries between it and the previously clicked entry
will be filled automatically and the box will move to the entry you just clicked
to indicate it is now the new start colour.
0 Repeat step 0 until the palette is configured as required.
You can work in either direction through the palette or even just fill part of it in this way.
To assign a colour to an individual palette entry without filling the intervening colours
simply switch back to Single mode.

Applying the formula palette to the image


To apply the formula palette to the active image, click Apply. A window is displayed
showing progress and allowing the operation to be cancelled if desired. If the results are
not satisfactory, adjust the palette settings and formula until the required results are pro-
duced. When you are happy with the results, click Save as... to save the image with its
formula palette as a new image document. Enter a name for the image in the window
which appears, then click Save.
When you have finished applying formula palettes to the image, set the state of the Open
last saved document when window is closed tick-box as required, then click Close. If
the tick-box was switched on, the image which was last saved in the Formula palette
window is opened automatically in a new document window.

Edit calibration...
Allows the constants used to calibrate the active image to be edited. The Calibration
editor window (figure 3.25) is displayed.

Figure 3.25 :aribratn ed:tc

The Calibration CaSbralxrr: Lchone1 1

editor window Corrstarrt CoeffaS


(Processing.Edit VISIBLE CHANNEL:
Slope A offoet: •2. 1415
calibration...) Slope A scple: 0.0551
1 Slope B xffxet: -55,8620
Slope S scale: 0.1625
I Breakpx:nt: 495

Import,.. Export,., Cancel J [oJ

Do not edit the calibration constants without fully understanding their


meaning and being sure of their accuracy. Incorrect constants will result in
inaccurate calibrated read-outs on images.

Choose the channel to edit using the Calibration drop-list and edit the constants as
required. Use the Import... and Export... buttons to load or save calibration data in a
file. Click OK to apply the new constants or Cancel to revert to the previous ones.
SOFTWARE MENU REFERENCE F3-45

[ j Manual calibration...
- Calibrates the infra-red channels of an image using the space and telemetry data present
in the image. If calibration is successful, temperature read-outs will then be available in
the calibrated value read-out for a plane in the read-outs panel (see section 2). This func-
tion is only available for uncalibrated APT images.

[ Temperature adjustment...
Allows the temperature calibration of the active image to be adjusted to compensate for a
locally-detected error. Applies only to calibrated APT images which have an infra-red
plane. The Temperature adjustment window (figure 3.26) is displayed.

Figure 3.26 mpratureustmnt

The Temperature offset:] EIi]


adjustment window The offset wifi apply only to the temperature
calibration of the currenhy-aclive $PT image.
(ProcessingiTemperature
adjustment...) L canciJ OK

Enter the offset to apply to the temperature calibration in the Offset box. Enter a positive
value to adjust the calibration upwards or a negative value to adjust it downwards. An
offset of 0 causes no adjustment to be made. Choose the units for the offset (°C or °F)
using the drop-list next to the Offset box.
All temperatures obtained from the image will be adjusted by the amount entered. For
example, if an offset of 3.2°C was entered, a calibrated temperature of 15°C would be
adjusted to 18.2°C. If an offset of —2.6°C was entered, a calibrated temperature of 15°C
would be adjusted to 12.4°C.

If a temperature calibration offset is applied to an image, the calibrated data


'—J"1 read-out in the read-outs panel (see section 2) will have a '+' symbol appended
to it to indicate that it has been adjusted.

To apply the offset to the active image, click OK, or to restore the previous offset, click
Cancel.

J Sharpen...
Allows the active image document to be sharpened, to enhance cloud detail for example.
The Sharpen window (figure 3.27) is displayed.

Figure 3.27 TIL°T


The Sharpen window 5everlty ------------------- Eli
(Processingo. [cani ][ OK
Sharpen.. .) ____

Use the Severity slider to set the amount of sharpening required between 1 (minimum)
and 10 (maximum) then click Apply to sharpen the image. If the results are not as
expected, adjust the Severity slider and click Apply again as required.
To keep the sharpening applied to the image, click OK, or to restore the image before it
was sharpened, click Cancel.

Soften...
Allows the active image document to be softened, to reduce noise for example. The
Soften window (figure 3.28) is displayed.
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

Figure 3.28
The Soften window Severity:
- iIII1
(ProcessingiSoften ... ) Apply ] (_Cencel - OK

Use the Severity slider to set the amount of softening required between 1 (minimum)
and 10 (maximum) then click Apply to soften the image. If the results are not as
expected, adjust the Severity slider and click Apply again as required.
To keep the softening applied to the image, click OK, or to restore the image before it was
softened, click Cancel.

Extract edges...
Allows edges in the active image document to be extracted (also known as edge enhance-
ment). The Extract edges window (figure 3.29) is displayed.

Figure 3.29
The Extract edges window Severity:

(ProcessingExtract Apply
1 P Cancel J L_1II]
edges...)

Use the Severity slider to set the amount of edge enhancement required between 1
(minimum) and 10 (maximum) then click Apply to extract edges in the image. If the
results are not as expected, adjust the Severity slider and click Apply again as required.
To keep the edge enhancement applied to the image, click OK, or to restore the image
before it was edge-enhanced, click Cancel.

LLJ
Blur
Blurs the active image document, to reduce noise for example.

Th Rotate sub-menu
The Rotate sub-menu provides functions for rotating faxes and un-navigated images.

i [pi>1 90°
Rotates the active image or fax clockwise through 90 degrees (quarter turn).

rni
1800
Rotates the active image or fax clockwise through 180 degrees (half-turn).

1 P1 j Flip sub-menu -
The Flip sub-menu provides functions for flipping (or mirroring) faxes and un-navigated
images.

i Horizontal ij
Flips (or mirrors) the active image or fax horizontally.

Vertical
Flips (or mirrors) the active image or fax vertically.
SOFTWARE MENU REFERENCE 3-47
- ------------ -

Navigation menu G
a... a ..fl..S$,..,fl.Se Ste...... S.ata..,ea.*mc*. S S.,.ae...StaaS,S, * ..............

The Navigation menu provides facilities for navigating images, adjusting map overlays,
calculating distances, bearings and profiles along a line, reprojecting images, applying
Blue Marble and DEM masks to images, editing reference points and converting vector
files.

Navigate E3 G-n
Navigates the active image if it is not currently navigated and creates a map overlay using
the default overlay settings. This function only works with polar-orbiter images created
using versions of iDAP prior to v8.0.

rN i, Swathe angle... G-ti


Allows the swathe angle used to navigate the active image document to be adjusted. The
Swathe angle window (figure 3.30) is displayed.

Figure 3.30 Swat tangle

The Swathe angle New ,wathe .rIe: 55,4500 degrees

window [caJ [_
(Navigation Swathe
angle...)

Do not adjust the swathe angle unless you know what you are doing and
A problems with navigation accuracy are being experienced.
Enter the new swathe angle, in degrees, in the New swathe angle box and click OK. The
image navigation will then be recalculated to use the new swathe angle.

N1 Nudge overlay mode


Switches on or off nudging of the map overlay on an image document (if the image has an
overlay). A map overlay may need to be nudged to match the features of the image if it
was not accurately navigated for any reason.
When nudge mode is switched on, the mouse cursor changes to a "move" pointer when the
mouse is moved over the image area. The map overlay can then be dragged around over
the image until it matches the image. Nudge mode should then be switched off again by
selecting NavigationNudge overlay mode, or by using the corresponding shortcut
button in the tool bar.

R. FN1 Distance, bearing and profile mode


Switches on or off calculation of the distance, bearing and profile along a line on the
image area of an image document. When this mode is switched on, click a point on the
image to set the start point of the line, then click another point to set the end point of the
line. The Distance, bearing and profile window (figure 3.31) is then displayed.
DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE

Figure 3.31
Disp1ay
The Distance, bearing Calibrated values VaIues
LIJ [atJ
and profile window Temperature units:
scale ya,ds automaRcafly

Read-outs
]R: P1 G: B:

Product Distance:
14501m
Bearing:

LiTi i

This window is a floating window, which means it can be moved anywhere on the screen
and stays on top of all other windows, and you can click the image area of another image
document window at any time to set the start point of a new line (if the image has been
navigated).
The profile, bearing and distance along the line are shown. To view the values along the
line, move the mouse cursor over the line on the image, or drag the Value slider on the
graph. The values and read-outs at the slider position are shown in the Read-outs area.
To view the profile of another line on an image document, click the new start and end
points on the required image. When you have finished using bearing and profile mode,
switch it off by selecting NavigationDistance, bearing and profile mode again, or by
using the corresponding shortcut button in the tool bar.

Display area
Use the Raw and Calibrated buttons to switch the profile displayed on the graph between
the raw pixel values and calibrated values. If the image is calibrated, both buttons will be
available, otherwise only the raw pixel value profile can be displayed on the graph.
Choose the units to use for temperature profiles using the °C and 'F buttons. Switch on
the Scale y-axis automatically tick-box if you want the vertical axis of the graph to be
scaled to fit the range of values present in the lines which are visible. This shows small
variations in a profile more clearly.

Read-outs area
If the image is multi-plane, three check boxes (labelled R, G and B) are shown at the top of
this area. These correspond to the red, green and blue lines on the graph, which in turn
correspond to the red, green and blue planes of the image. Under each tick-box, the
profile value at the current Value slider position is displayed for its corresponding plane.
Use the R, G and B tick-boxes to show or hide the profile for each plane of the image. This
feature is useful if the profiles for two planes are very similar, and therefore one is
obscured by another.
If the image is single-plane, the profile value at the current position of the Value slider is
shown in the Value box.
If the image is a formula palette product (see ProcessingFormu1a palette...), the
Product tick-box can be used to show or hide the product profile, which appears as a
yellow line on the graph. The product read-out at the current Value slider position is dis-
played below the Product tick-box.
Bearing shows the bearing from the start point of the line to the point corresponding to
the current position of the Value slider graphically (on the compass) and numerically.
Distance shows the distance to this point in miles, kilometres and nautical miles.

SOFTWARE MENU REFERENCE

'[r.ij Projection transform... —TI

Allows an image document to be transformed to fit a map projection. The Projection


transform window (figure 3.32) is displayed.

Figure 3.32
The Projection Map opbon

transform window equwectanQular


cII E. E
(Navigation.
Projection
transform...)

Show overlays

Ease image

Required size: 50000 3000 pixels

Image processing
Slice:

[1Apc y musk usmro colour:


IE[
[] Recalculate enhancement (destroys any pracessmg applied to the image)
[save as.. -. open last saved document

Map option area


Choose the required map option from those available in the drop-list. A preview of the
area covered is shown below the drop-list. Use the Show overlays tick-box to show or
hide the preview's map overlays. Move the mouse over the preview to obtain latitude and
longitude read-outs. Use the and 0. buttons to change the magnification of the
preview. Note that this does not affect the size or magnification of the projected image.
To edit or delete the selected map option or add a new one, click Edit.... The Map
options manager window (figure 3.36) is displayed. Use it to edit, delete or add map
options as required, then select the required map option and click Close. See
NavigationMap options... for more information.

Base image area


This area allows a base image to use as the background to be chosen. The transformed
image will be superimposed on to the specified image, the required size of which is shown
below the box. Click Choose... and choose an image document in the window which
appears (similar to that shown in figure 3.1). To unassign a base image, click Clear.

A mosaic of many different images can be built up by transforming all the


'1 required images, specifying the same mosaic base image each time and
saving the results to that image.

Image processing area


The Slice slider allows pixels whose values fall below the specified level, in percent, to be
sliced out of the resulting image. This enables, for example, only cloud cover to be
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

included in the projected image. A Slice value of 0% includes all pixels, and a value of
100% includes no pixels. Experimentation is required to determine a suitable setting for
the Slice slider.
The Apply mask using colour tick-box determines whether or not the mask file for the
map option set is applied to the projected image, to mask out areas of land for example.
See appendix A for information on creating mask files. The colour picker button allows
the mask colour to be chosen from the grid which pops up. To specify a custom colour,
click the Other... button below the grid.
The Recalculate enhancement tick-box determines whether or not the projected image
will be re-enhanced. If switched off, the current appearance of the image, including all
processing applied so far, is retained in the projected image. If switched on, the projected
image is re-enhanced, destroying any processing which has been applied to the image, but
resulting in brightness and contrast levels which take into account the differing his-
tograms of the source and projected images.

Generating the projected image


Click Transform to begin the projection transformation process. A window is displayed
showing progress and allowing the operation to be cancelled if desired. When the trans-
formation is complete, a preview of the projected image, with its map overlays, is dis-
played on the right-hand side of the window. If the results are not as required, adjust the
projection settings and click Transform again until you are happy with the resulting
image. Click Save as... to save the transformed image as a new image document. Enter a
name for the image in the window which appears, then click Save.
When you have finished creating transformed images, set the state of the Open last saved
document tick-box as required, then click Close. If the tick-box was switched on, the
image which was last saved in the Projection transform window is opened automatically
in a new document window.

F
Nl Blue Marble masking...
- Allows a mask to be generated from NASA Blue Marble data and applied to the active
- image. The Blue Marble masking window (figure 3.33) is displayed.

Figure 3.33 Mi-b'iaol&

The Blue Marble Image processing


Shce C""" Sj Opaaty:
masking window
(NavigationBlue Source
Marble masking...) Data set: [_pogr iy+Aathymeb'y 2054-01 anuary)i minute
0etalls Mabix size 21600 x 10800, top left at 1 g0W, 9SN
Longitude retolulon 1,0, loltude resoluSon 1.0 (nonutes of,rc)
Aintrowledgemenn glue Marble imagery is a public serince b y NASA. See

F-]
httu:jfearthobserv,tar y , yusa,cuvRqewsruomueMurble for details.

Icanc L...°..

Image processing area


The Slice slider allows pixels whose values are above the specified level, in percent, to be
sliced out of the Blue Marble mask. This enables, for example, cloud cover to be excluded
from the mask. A Slice value of 0% excludes all pixels and a value of 100% includes all
pixels. Experimentation is required to determine a suitable setting for the Slice slider.
The Opacity slider allows the opacity (or transparency) of the Blue Marble mask to be set.
The lower the opacity, the more visible through the mask the underlying image will be.
An Opacity of 0% produces an invisible mask, and a value of 100% a completely opaque
SOFTWARE MENU REFERENCE3-51

mask through which none of the underlying image is visible. Values between these limits
allow images to be tinted to give them texture without completely losing the underlying
data. Experimentation is required to determine a suitable setting for the Opacity slider.

Source area
This area allows the data set to use to generate the Blue Marble mask to be chosen.
Choose the required data set from those available in the Data set list. Any GRD98 format
Blue Marble data file (with header) can be used. Information about the selected file is
shown in the Details box below the list.

The complete Blue Marble data library comprises 24 files approximately 700MB
h1
40 each. They are therefore supplied on a set of DVDs available from Dartcom if
not supplied with your system. Please contact us for more information.

Applying the Blue Marble mask


To apply a Blue Marble mask with the chosen settings to the image, click Apply. A
window is displayed showing progress and allowing the operation to be cancelled if
desired. If the resulting Blue Marble mask is not satisfactory, adjust the mask settings
until the required results are achieved.
To keep the mask applied to the image, click OK, or to restore the image before the mask
was applied, click Cancel.

'ti N 1 DEM masking... Li


Allows a mask to be generated from Digital Elevation Model (DEM) data and applied to
the active image. The DEM masking window (figure 3.34) is displayed.

Figure 3.34
The DEM masking Land mask RiSea mask
Pd type: Colour 1: Fill typo: Colour 1:
window C Sold
(NavigationeDEM tl Graduated by height:
© Said
I) Graduated by depth:
[E
Colour 2: Colour 2:
C Colour 1 highest © Colour I deepest
masking...) @) Colour 2 highest ® Colour 2 deepest [IE1
C Graduated atlas colours () Graduated atlas colours

Image processing
Slice: C iL© i Opacity: -t

Source -
Data set: ETOPO2 global 2 minute -.
Detain:laSiosine 1050005400, tap Left at 180-W, 90'N
Longitude resoluoon 2.0, laltuderesolution 2.0 (minutes of arc)
Acknowledgement: GE000S and ETOPO formats and data are part of a
public seraice b y the U.S. Department of Commerce, NOAS, NESDIS and
NGDC, See httm:// wwngdc,rroaa. gonfrmdcinforivacy .h0nl for details.

C] Create mo plo fin


C:\Dar tcomVmaQes\5amP1eimaaes and an:mabontytyrm.dem choosej

Applu L Cancel OK j

Land mask area


This area allows the land mask settings to be changed. Switch on the Land mask tick-
box to include all areas of land in the DEM mask. Choose the method to use to fill the
mask using the Fill type radio buttons. If Solid is selected, all land will be filled with a
single colour. Click the Colour 1 button and choose the fill colour from the grid which
pops up, or click Other... to define a custom colour.
If Graduated by height is selected, the land will be coloured differently according to
height. Click Colour 1 highest if you want colour 1 to be assigned to the highest point on
the image and colour 2 to the lowest point, with graduations between the two colours
E3:-^
_fla
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

assigned to altitudes in between. Click Colour 2 highest if you want the opposite to
happen (colour 2 assigned to the highest point and colour 1 to the lowest point). Click the
Colour 1 and Colour 2 buttons to choose the two colours to use.
If Graduated atlas colours is selected, the land will be coloured differently according to
height using predefined colours similar to those found in an atlas.

Sea mask area


This area allows the sea mask settings to be changed. Switch on the Sea mask tick-box to
include all areas of sea in the DEM mask. Choose the method to use to fill the mask using
the Fill type radio buttons. If Solid is selected, all sea will be filled with a single colour.
Click the Colour 1 button and choose the fill colour from the grid which pops up, or click
Other... to define a custom colour.
If Graduated by depth is selected, the sea will be coloured differently according to depth.
Click Colour 1 deepest if you want colour 1 to be assigned to the deepest point on the
image and colour 2 to the shallowest point, with graduations between the two colours
assigned to depths in between. Click Colour 2 deepest if you want the opposite to
happen (colour 2 assigned to the deepest point and colour 1 to the shallowest point).
Click the Colour 1 and Colour 2 buttons to choose the two colours to use.
If Graduated atlas colours is selected, the sea will be coloured differently according to
height using predefined colours similar to those found in an atlas.

Image processing area


The Slice slider allows pixels whose values are above the specified level, in percent, to be
sliced out of the DEM mask. This enables, for example, cloud cover to be excluded from
the mask. A Slice value of 0% excludes all pixels and a value of 100% includes all pixels.
Experimentation is required to determine a suitable setting for the Slice slider.
The Opacity slider allows the opacity (or transparency) of the DEM mask to be set. The
lower the opacity, the more visible through the mask the underlying image will be. An
Opacity of 0% produces an invisible mask, and a value of 100% a completely opaque
mask through which none of the underlying image is visible. Values between these limits
allow images to be tinted, with green land and blue sea for example. Experimentation is
required to determine a suitable setting for the Opacity slider.

Source area
This area allows the data set to use to generate the DEM mask to be chosen. Choose the
required data set from those available in the Data set list. Any GRD98 format DEM data
file (with header) can be used. Information about the selected file is shown in the Details
box below the list.

Create matrix file area


Switch on the Create matrix file tick-box if you want to export the DEM mask to a matrix
file when it is applied to the image. The matrix data is exported in standard DEM format
(16-bit signed integers). Click Choose... and use the Save as window (the same as that
described in File .Save as...) to change the name of the matrix file.

Applying the DEM mask


To apply a DEM mask with the chosen settings to the image (and export it to a file if
Create matrix file is switched on), click Apply. A window is displayed showing progress
and allowing the operation to be cancelled if desired. If the resulting DEM mask is not
satisfactory, adjust the mask settings until the required results are achieved.

SOFTWARE MENU REFERENCE


as.r

To keep the mask applied to the image, click OK, or to restore the image before the mask
was applied, click Cancel.

INI Overlay settings... 9 G-n


If an image document is active, this allows the image's map overlay settings to be changed
(if supported for that image type), otherwise it allows the default overlay settings for new
images to be specified. The Overlay settings window (figure 3.35) is displayed.

Figure 3.35 Overlay ett - - - - -- - -

The Overlay settings Create overlays


Grid lines
window 5paeQ Colour: Style: Width:
(Navigation-Overlay IMajor [10.0 ..ldegrees J[so ..]fmla
settings...) [Moryr .o .'ldegrees [Oasted .j[mi •1
Overlays
1 . No, Overlay Coloor Style Width

LAd4sveay1 teo,T] I I M Ilep [Movedown7



default] [ve as defaj Cancel OK

Switch on Create overlays if you want overlays to be created. In the Grid lines area,
switch on Major and Minor to create grid lines. For each type, set the spacing using the
Spacing drop-list, the colour in which to draw them using the Colour palette pop-up, the
line style using the Style drop-list and the line thickness using the Width drop-list.
Normally the minor grid line spacing should be half that of the major grid lines and they
should be drawn using a dashed line.
The Overlays list and the row of buttons below it allow overlays to be added, edited and
deleted. For each overlay, switch on its corresponding tick box if you want it included in
the created overlays, select the required overlay using the drop-list in the Overlay column,
choose the colour in which to draw it using the palette pop-up in the Colour column,
choose the line style using the drop-list in the Style column and choose the line thickness
using the drop-list in the Width column.
To add a new overlay, click Add overlay and specify its settings as described above. To
delete an overlay, select it by clicking in its No. column, then click Delete overlay....
The overlays are drawn in the listed order, starting at the top. If you want to change the
drawing order (because one is being partially obscured by another, for example), select
the required overlay by clicking in its No. column, then click Move up or Move down to
move it up or down the list respectively.
If you want to reset the overlay settings to the current defaults, click Reset to defaults....
The factory default settings are used if an image document is not active.
To set the current overlays settings as the defaults, click Save as defaults.... This button
is only visible if an image document is active.
To apply the overlay settings to the active image document (or save them as the defaults if
no image document is active) click OK, or to revert to the previous settings click Cancel.
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

Map options... G-n


Allows the map options used by the raw data exporters and project transformation facili-
ties in iDAP and MacroPro to be added, edited and deleted.
A map option defines the size, map projection and geographical area of a transformed
image. You can set up map options for areas of interest so they can be recalled quickly.
The Map options manager window (figure 3.36) is displayed.

Figure 3.36 Map opt:onsnnanag.r - -__ -- - - - --


Mapowg
The Map options Map spoon: EumopO Egcanrctaygoler lt,n - )< IØ Mode: &JEasy
manager window CO) Cartographic (advance,
Pro)e000n: Earth yodel:
(Navigation-Map [tojareftangar. •1 SpherC RadyvOiOG991w
Offset type false nsrthargs (- Imoescale tattode: Central meridian:
options...) to move map northwards, and 90 470000 qu 00000 .y
to 1101on - appr000rrmately o)
are mequved if cerype of nap is False northing: False tasting:
not totme at &ther pole or the
equator. 5240,0000 Ion 00000 I.
Cyt.mdrical -to equatonal aspect 51.ovd .t:d pm: rinI 1: :cydvrdWald 2:
all parallels are straight
tmor:rontal, ol nmeridIamm are
straight vertical and caufornisy
1
spaced.
Eqcisdotant - Stoles constant
along standard, not necessarty
straight, tnes

Image
Width: Height: Pesolutwn:
5000 o 3000 pmoelt 1.0000 len

Ioveisavn.J 1i]
Oooe -}

To load an existing map option, choose it from those available in the Map option drop-
list. A preview of the area covered is shown below the drop-list. Use the and 'Ek a
buttons to change the magnification of the preview. Note that this does not affect the size
or magnification of the transformed image.

You can read off latitudes and longitudes from the map option preview by
" moving the mouse cursor over it.

If you make any changes to the selected map option, click the 9 button to save them. To
save the current projection settings as a new map option, type the required name in the
Map option box and click the Q button. To delete the selected map option, click the X
button.

After making changes to any of the mapping settings, image settings or


-J"1 overlays, click Apply to update the preview.

Mapping area
This area allows the projection type and parameters to be specified. It can be used in two
modes. In easy mode, the map centre is specified and the projection parameters are cal-
culated automatically. In cartographic mode, the projection parameters must be calcu-
lated and entered manually. Click the Easy or Cartographic radio button as appropriate
to select the required mode.
Select the required map projection from those available in the Projection drop-list. A
description of the selected projection and its parameters is displayed in the box under-
neath the drop-list.
SOFTWARE MENU REFERENCE i 3-55

If the selected projection allows it, select the required earth model (or spheroid) from
those available in the Earth model drop-list. WGS 84 is the earth model most commonly
used for mapping.
Enter the projection parameters in the boxes below the Earth model drop-list. The titles
and availability of these boxes will vary according to the selected mode and projection.
To update the preview after making changes to the mapping settings, click Apply.

Image area
Enter the required width and height (in pixels) and resolution (in kilometres) for the
transformed image. To update the preview, click Apply.

Overlays.., button
To configure the map option's overlays, click Overlays.... The Overlay settings window
(figure 3.35) is displayed, allowing grid lines and overlays to be switched on or off and
their colours and styles to be changed. This window is described in NavigationOverlay
settings....

Reference points... S-n


Allows the reference points displayed on navigated images to be defined, switched on or
off and saved in databases for quick recall. The Reference points window (figure 3.37) is
displayed.

Figure 3.37
The Reference points
window
(Navigation Reference
points...)

Choose the reference points database to use from those available in the Database drop-
list. If you make any changes to the chosen database, click the 9 button to save them.
To save the current reference points in a new database, type the required name in the
Database box, then click LI. To delete a database from the list, click the X button.
The table allows reference points in the current database to be added, edited and deleted.
The tick-boxes in the first column of the table switch display of their corresponding refer-
ence points on or off. To edit the latitude, longitude or title for a reference point, select it
in the table and click the mouse in the appropriate column. After a short pause, the field
becomes editable. Latitudes must be entered in degrees North (negative for degrees
South) and longitudes in degrees West (negative for degrees East).
DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE

To add a new reference point, click Add. To remove a reference point, select it in the table
and click Delete. The Cut, Copy and Paste buttons allow reference points to be moved or
copied between databases. The Move up and Move down buttons allow the order of the
reference points to be changed manually. The Sort alphabetically button sorts the list in
ascending alphabetical order.

Multiple reference points can be selected using Shift+click (contiguous range)


-1"1 and CtrI+click (separate points).

To close the Reference points window, click Close.

Overlays utility... -ri


Allows overlay data files to be converted between Dartcom (DWF) and text formats. The
Dartcom Overlays Utility program (figure 3.38) is started.

Figure 3.38
The Dartcom Overlays Import overlay from text file

Utility program Text file:

(Navigationo. Overlay flame:

Overlays utility...) LIII1


Export overlay to text file
Overlay: [ - 1- Refresh_i

Import overlay from text file area


Choose the text file to import by clicking Choose..., enter a name for the overlay and click
Import. The specified file is imported and the new overlay created in the Map overlays
path configured in the Configuration window (UtiitiesConfiguration ... ).

Export overlay to text file area


Select the overlay to export using the Overlay drop-list. If necessary click Refresh to
update the list. Click Export..., enter a name for the resulting text file and click Save.
SOFTWARE MENU REFERENCE3-57'

U} Utilities menu
The Utilities menu provides additional utility functions, such as changing the configura-
tion of the iDAP and MacroPro software, automatic document updating and processing,
and locking and unlocking the software.

[ j] Configuration... 3-n
Allows the iDAP or MacroPro configuration to be changed to suit different requirements.
The Configuration window (figure 3.39) is displayed.

Figure 3.39 fguration -- --

The Configuration
window (Utilities Details

Configuration...) Name: Dartcom

Desa,pbon: Daricam ground station

Logo: - - [choose..1 [_Remove

position
F1 Update automatically
Source: File:
C:Lisers\Dartcvm\A ppDataWoamin gipar tcom\Cor [choos!j

Fined:

In: ci cii, 50.S76

Format: ddd.ddd
dddNnmmmm
) dddNnmss.s (d-degrees, m—inutes, s=secovds)

Icance1 ][ OK

In MacroPro, a Synchronise with iDAP button is also shown in the bottom left corner of
the window. This synchronises the MacroPro configuration with that of MAP, enabling
changes made to the iDAP configuration to be applied quickly to MacroPro.

iDAP and MacroPro have independent configurations to allow them to be


-1'" configured differently if required. If you make changes to the iDAP
configuration, click the Synchronise with iDAP button in MacroPro to apply
these changes to MacroPro.

Station tab
The Station tab allows the details of your ground station to be changed and the position
source to be configured.
In the Details area, enter a name and description for the ground station in the Name and
Description boxes. The name is used to label the station point on image documents.
Logo is the bitmap file which you want to be used as the logo for your ground station. If
you want to specify a logo, click Choose... and choose a file using the window which
appears. To remove the current logo, click Remove. The description and logo appear on
all printed output from iDAP or MacroPro.
The Position area allows the source from which to obtain the position and its display set-
tings to be changed. If you want the ground station position to be updated automatically
from the position obtained by the ingest software, switch on Update automatically.
LDARTCOMIDAP/MACROPRO SOFTWARE USER GUIDE

If GPS-aware ingest software (such as Dartcom Polar Orbiter Ingester) is running on your
computer or network, set Source to File, then click Choose... to set the path into which
the ingest software is exporting the station position.
If your ingest software is not GPS-aware (such as Dartcom XRIT Ingester or GVAR
Ingester) or you do not have any ingest software on your computer or network, set Source
to Fixed and enter your station position in the Latitude and Longitude boxes, in degrees
North and West respectively.
Choose how you want latitudes and longitudes to be displayed in the read-outs panel (see
section 2) using the Format radio buttons (d corresponds to degrees, m to minutes and s
to seconds). This option is available in iDAP only.

Paths tab
The Paths tab (figure 3.40) allows the various paths used by the software to be changed.
In MacroPro, only the iDAP documents, exported data, map overlays and temporary
storage paths are visible and can be changed.

Figure 3.40
The Configuration
window with the Paths CAP documents: C:artco&ttmages
tab displayed Exported data: CDartcom\nsapesxport Chopse.i

Map overlays: C:(rogram Ftes'partcnmtap overlays

Temporary storage: C:\Users\Dakonr\Appyat&tocal\Temp [choose... I


-(OPT arcivve: CparivvmataRPT [choose...]
CHOPT arch:ve: C: \D [_c.
SeaWIPS archive: CCartcompataea¼MPS - Ichoose...
A(-IRPT archive: Cpartcomata\4J-WPT choose]
DMSP archive: C:artcvnr(PataMSP Chaos.

LelL1-IRrr archive: [vase... 1

EJ Li

iDAP documents is where images, animations and faxes can be found and are saved by
default. Exported data is where images and data exported using the Fi1eExport sub-
menu are saved by default. Map overlays is where map overlay files can be found.
Temporary storage is the folder which iDAP or MacroPro uses to store temporary files.
To change a path, click its corresponding Choose... button. Select an existing folder or
create a new one in the window which appears (similar to that shown in figure 3.3) and
click OK.
If your Dartcom software licence includes digital polar orbiter data, the HRPT archive,
CHRPT archive, SeaWiFS archive, AHRPT archive and DMSP archive paths are also
available. Set each of these paths to the folder in which the Dartcom Polar Orbiter
Ingester software is archiving the corresponding data type.
If your Dartcom software licence includes LRIT/HRIT data, the LRIT/HRIT archive path
is also available. Set this path to the folder in which the Dartcom XRIT Ingester software
is archiving data.
SOFTWARE MENU REFERENCE

Session tab
The Session tab (figure 3.41) allows the behaviour of iDAP and MacroPro between ses-
sions to be configured.

Figure 3.41
The Configuration Session

window with the Per Orstence

Session tab displayed Between sessions, remember:


J Size and Position of main window
1 Configuration of tool bar, panels and status bar
Open document orndows
[] Positions of floating windows

Cancel L. OK J

The Persistence area allows configuration of the extent to which iDAP or MacroPro
remembers and restores settings from a previous session. The size and position of the
application window, the configurations of the tool bar, panels and status bar, and the posi-
tions of floating windows can all be remembered. Additionally, the documents which
were open in the previous session can be opened automatically when iDAP or MacroPro is
next used.

iiP. Setup assistant... G G-n


Allows support files from previous versions of iDAP to be imported and the default
presets to be installed. The Setup assistant window (figure 3.42) is displayed.

Figure 3.42
The Setup assistant Welcome to lttsP, Dartcoms integrated display and processing software for
satellite imagery and meteorological data.
window Please choose how you want DAP to be configured initially.
(UtilitiesSetup Map options Enhancement presets
U trrryrv: t nid ftrrnrnt duta M Import old format data
assistant...) Instal defaults 23 Instal defaults
Overwrite if names are the same n Overwrite if names are the same

Reference point databases Automatic processing macro sets


] Import old format data 1 Instal defaults
[1 Instal defaults U]Overwrite if names are the same
P1 Overwrite if names are the same
tan,j[tmportoaoe__I
Formula palette presets
[]Instal defaults Installall] -gnstatnone .1
I Overwrite if names are the same Overwrite aB [rite n1

If you want to get started qu:ctdy and have not upgraded from a previous
O version simply duds tootioue.
To run this setup assistant again at any time, pots the ljtllrtieo' menu and select
Setup assistant....
] { Contnue

Choose how you want iDAP to be configured using the tick-boxes. In most cases you can
use the default settings and simply click Continue.
L3- L60_jl DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
- tr— ______.-...ac-fl rrrrne*rtc-r -w---eff-or-t---t-tr- -'.auron,

Security...
Allows sensitive functions of the software (such as FileSave and FileExit) to be locked
and unlocked. When locked, documents can be viewed normally and a limited number of
processing functions can be performed, but documents cannot be printed or modified
permanently, and the software cannot be closed. If the software is currently unlocked, the
Lock iDAP (or Lock MacroPro) window (figure 3.43) is displayed. If currently locked,
the window is titled Unlock iDAP (or Unlock MacroPro) instead, but has a similar
layout.

Figure 3.43
The Lock iDAP window Please enter a password of your choice which will be
needed to unlock the sensitive functions of DAP.
The password It case-pantOne,
(UtilitiesSecurity ... )
Password: I
And again:

cornet ] [ OK

Locking the software


To lock the software, enter a suitable password in the Password box. The password is
concealed on the screen by asterisks (6*') to prevent others from seeing it.

The password is case-sensitive, which means that upper-case letters are


-1"1 treated as being different to their lower-case equivalents (for example 'A' is
not the same as 'a').

Make a note of the password entered, as it will need to be entered again to


unlock the software. There is no direct way to unlock it other than re-entering
the password which was used to lock it. If you forget the password, you will
have to contact Dartcom for technical support.

Type the password again in the And again box, exactly as it was typed in the Password
box. Click OK to lock the software, or Cancel if you don't want to lock it. If the passwords
in the Password and And again boxes match, the software will now be locked, indicated
by the Locked message in the status bar. If the passwords did not match, a window
appears informing you of this. Re-type the password in both boxes, then click OK again.

Unlocking the software


If unlocking the software, the window will be titled Unlock IDAP (or Unlock MacroPro).
To unlock it, enter the password which was used to lock it in the Password box, remem-
bering that it is case-sensitive (see note above). The password is concealed on the screen
by asterisks (6*) to prevent others from seeing it. Click OK to unlock the software, or
Cancel if you decide not to unlock it. If the password entered matches the password
which was used to lock it, it will now be unlocked, indicated by the Unlocked message in
the status bar.
If the passwords did not match, a window appears informing you of this. Re-type the
correct password, then click OK again. If, after several attempts, you are unable to unlock
the software, please contact Dartcom for technical support.

rjj] Automatic update I-n


Switches on or off automatic updating of all open image, animation and fax documents.
When automatic updating is switched on, iDAP reloads a document automatically when
its data files have been updated (by its associated capture system, for example).
SOFTWARE MENU REFERENCE

A message and a small activity indicator in the status bar show whether or not automatic
updating is switched on and functioning properly. The indicator changes every ten
seconds when automatic updating is switched on to show that it is functioning correctly.

Start MacroPro...
Starts the MacroPro automatic processing software if it is not already running. MacroPro
minimises into a task bar button automatically when it has finished starting up.

Start MacroPro automatically


Switches on or off automatic starting of MacroPro when iDAP is first opened.

1J1 Automatic processing 0 0-n


Switches on or off automatic processing in MacroPro. When switched on, all documents
for which automatic processing macros have been defined and switched on in the cur-
rently active macro set (see UtilitiesAutomatic processing settings...) will be
processed automatically each time their corresponding data files are updated (by their
associated capture systems, for example).

M Automatic processing settings... 0 0-n


Allows the currently active automatic processing macro set to be chosen, and allows
macro sets to be created, edited, saved and deleted. The Automatic processing window
(figure 3.44) is displayed.

Figure 3.44
The Automatic Current macro Set:

processing window
Default x
Macro settings for selected visage
(Utilitieso. Images
Latest HRPT mmage 1-2-4.d:d
Document: C:mpartcomtjmagesVietap 1-2-4d:d - [ctioone.i
Automatic processing Latest HRPT 4.d Processaig:
-------------- Settings for selected operation
settings...) Metop t.24.dmd
F2 LP.ST MET? SS_7_Dt?Sd:d
. Operations © Use profile:
P-
12 LMMSG2 IR_108d,d Navigate
LRIT MSG2 VIS006.d:d
0
I 0 Red Sea and Gulfd:d
Blue Marble Use preset:
{ OEM I
[] Export image - -
] Export data
Print
J Save
Archive
MV Animate
Repraject
Create palette

st
[To top i [ctJp xu[ [Down. j [To bottoerl

[ca[oKi]

A macro set is simply a list of image documents and their corresponding processing set-
tings (or macros). Each image in the macro set will be processed automatically each time
its data files are updated (by its associated capture system, for example). You can define
different macro sets for specific purposes or users, for example. Only one macro set can
be active at a time, but the currently active macro set can be changed at any point.

Choosing, saving and deleting macro sets


The Current macro set drop-list allows the currently active automatic processing macro
set to be chosen. To change the current macro set, choose the required set from those
available in the drop-list. To save changes to the current macro set, enter a new name for
the macro set in the Current macro set drop-list if required, then click the button. To
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
[ 3-62J

delete the current macro set, click the > button. To create a new, blank macro set, choose
(new) in the drop-list.
The image documents which will be processed automatically whilst the current macro set
is active are shown in the list below the Current macro set drop-list. Next to each image
is a tick-box which switches on or off automatic processing of that image. Use the All on
and All off buttons below the list to switch processing of all images in the macro set on or
off respectively.

Creating, deleting and sorting macros


To create an automatic processing macro for an image document, click Add... (below the
list of images). The Image to process window (similar to that shown in figure 3.1) is dis-
played. Navigate to and select the image document you want to be processed, then click
Choose. The chosen image will be added at the bottom of the list and highlighted so its
macro settings can be edited (see below).

If required, more than one automatic processing macro can be defined for an
do))) image document. This allows an image to be exported in several different
formats or reprojected to a number of different projections, for example.

To delete a macro for an image document, select the image in the list and click Delete.
To change the position in the list of a macro for an image document, select the image and
use the To top, Up, Down and To bottom buttons accordingly.

Editing a macro
To edit the macro settings for an image document, select the image in the list on the left-
hand side. The macro settings are then shown in the Macro settings for selected image
area on the right-hand side.
The full path and name of the image document whose macro is being edited are shown in
the Document box. To change the image document associated with the macro, click the
Choose... button, select the required image document, then click Choose.
The processing operations (summarised in table 3.4) which can be performed on the
image are shown in the Processing list. Next to each operation is a tick-box which allows
the operation to be switched on or off. Use the All on and All off buttons below the list to
switch all the operations on or off respectively.

SOFTWARE MENU REFERENCE

eration lv u ctió P
[Results
Automatic processing. - -. - ---------- original
-
operations Eance 1ProcessingiEnhance j Enhances imagJ
Iavigates processed image
Blue Marble NivigationBlue Marble masking 1rApplies Blue Marble mask to
processedimage
[DEMj7ig_a_ti6n_o,.DEM masking liés DEMiask to
pro ces sea image
Expprt FiIeExportIhag _______- Exports
Ij processed image to

F image
a new graphics file
Export data leExportData Exports raw, unprocessed
________ _________________ image
iL data to a new file
Pn1Print __ Pnnts processed nage
j FiIeSaveAs_ ____- Saves processedimage
hive Nine --__- tesrollirfgarchive of -
processedimages
Animate None LAnimates processd image,
producing a new animation
document (or updating the
existingone)
Reprojt - iigationProjection transfi 1Reprojectsrocessed
image saving results as a
new imagedocun-int
Cree
at ProcessingFormuIapalette ___- Applié?foriula palette t o
palette processed image (excluding
reprojection) saving results
J - asanew _image document

To change the settings for a processing operation, select the operation in the list to display
its settings (if any) in the Settings for selected operation area. The settings for each
operation are described below.
Enhance settings
Figure 3.45 c,, UseoIe:
The automatic 0 - •1
enhancement settings use preset:

To apply one of the standard enhancement profiles (see table 3.3) to the image, click the
Use profile radio button and choose the required profile in the drop-list.
To apply a pre-defined enhancement preset (see ProcessingEnhance ... ) to the image,
click the Use preset radio button and choose the required preset in the drop-list.

[3-64 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE


J

Blue Marble settings


Figure 3.46
........... . ...
The automatic Blue .. I ....,,,
Marble masking settings Data set: [Topogrephy ..8attiymey 200401 (January) Indnute.
Detain: I Motes sue 21600 a 10000, top left att00'W,gO'tt
[Longitude resolution 1.0, latitude resolution 1.0 (minutes of
arc)

The settings for this operation are almost identical to those in the Blue Marble masking
window (see Navigation-Blue Marble masking...).
The Slice slider allows pixels whose values are above the specified level, in percent, to be
sliced out of the Blue Marble mask. This enables, for example, cloud cover to be excluded.
A Slice value of 0% excludes all pixels, and a value of 100% includes all pixels.
The Opacity slider allows the opacity (or transparency) of the Blue Marble mask to be set.
The lower the opacity, the more visible through the mask the underlying image will be.
An Opacity of 0% produces an invisible mask, and a value of 100% a completely opaque
mask through which none of the underlying image is visible. Values between these limits
allow images to be given extra texture without completely losing the underlying data.
Select the required Blue Marble data set from those available in the Data set list.
Information about the selected file is shown in the Details box below the list.

DEM settings
Figure 3.47 R Sea ask
Solid
The automatic DEM t) Graduated by height:
ntutd
@ Graduated by depth:
masking settings tCoIour ihighest
) Colour 2 highest
colour ldeepest
Colour 2 deepest
C?) Graduated atlas colours 0 Graduated atlas colours
Colour 1: Colour 2: Colour 1: Colour 2:
Iv FIREE
Image processing
Slice: Opacity: -

Data set: [ETOPO2global 2nrinute


Details: Mates size 10000 x 5400, top left at 130'W, 90'Dt
Longitude resoluoon 2,0, latitude resolution 2.0 (minutes of
L.
arc)

The settings for this operation are almost identical to those in the DEM masking window
(see Navigation'DEM masking...).
Switch on the Land mask tick-box to include land in the DEM mask. Choose the fill
method for the mask using the radio buttons. If Graduated by height is selected, choose
whether colour 1 or colour 2 should be used for the highest point. Choose the colours for
the mask using the Colour 1 and Colour 2 buttons as appropriate.
Switch on the Sea mask tick-box to include sea in the DEM mask. Choose the fill method
for the mask using the radio buttons. If Graduated by height is selected, choose whether
colour 1 or colour 2 should be used for the highest point. Choose the colours for the mask
using the Colour 1 and Colour 2 buttons as appropriate.
The Slice slider allows pixels whose values are above the specified level, in percent, to be
sliced out of the DEM mask. This enables, for example, cloud cover to be excluded from
the mask. A Slice value of 0% excludes all pixels from the mask, and a value of 100%
includes all pixels in the mask.
SOFTWARE MENU REFERENCE
' - .. Ctrrr'a e . S%iu & ta:t$Wnt, Sofl . . Me ,4

The Opacity slider allows the opacity (or transparency) of the DEM mask to be set. The
lower the opacity, the more visible through the mask the underlying image will be. An
Opacity of 0% produces an invisible mask, and a value of 100% a completely opaque
mask through which none of the underlying image is visible. Values between these limits
allow images to be tinted, with green land and blue sea for example.
Select the required DEM data set from those available in the Data set list. Information
about the selected file is shown in the Details box below the list.

Export image settings


Figure 3.48
J flfle M Lat,lon legends
The automatic image I Infalrmagon Frequency:
export settings Maps and degrees
Stagon position
Reference punts

File format: [FEG vJ Quality: C


[]Reduce to 8t
File name: C:'Partcorn\lnragesV'letop 1-4

Arthue files in:


C:rpartcom\JmagesWddne

Delete files over 7


7P days old I!] Legacy mode

The Options area controls the items to include in the exported image. It is equivalent to
the Options area in the Image export options window (see FileExporDImage ... ).
Select the file format for the exported image from those available in the File format drop-
list. If the JPEG format is chosen, the Quality slider can be used to specify the quality of
the exported image. 0% gives the lowest quality (highest compression) and 100% the
highest quality (lowest compression). Use the Reduce to 8-bit tick-box to choose
whether or not to reduce the exported image to 256 colours (eight bits per pixel).
The file name for the exported image is shown in the File name box, and defaults to that
of the macro's associated image with the extension removed. The extension for the
selected file format (".tif" for the TIFF format, for example) will be appended to the file
name when the image is exported. To change the file name, click Choose... and specify
the location and new name for the exported image in the Save exported image as
window (similar to that shown in figure 3.5).
If you want a rolling archive of exported images to be maintained, switch on the Archive
tick-box. Set the archive path by clicking Choose... and selecting the required folder in
the Archive path window which appears (similar to that shown in figure 3.3).
To delete archived images when they exceed a maximum age (recommended to avoid the
disk filling up) switch on Delete files and enter the required number of days in the box, or
adjust it using the Ff buttons. The minimum is 1 day and the maximum 366.

Ensure that the specified archive period can be accommodated within the
available disk space. Calculation and experimentation may be required to
determine the appropriate period.

The Legacy mode tick-box should only be switched on if you require the archive folder
structure and naming to be compatible with versions of MacroPro prior to v8.0 (folders
named "Weekly", "Monthly" or "Yearly").
3-66 1 DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
rwwo:. -

Export data settings


Figure 3.49 Data

The automatic data


Plane: [Red/Grey .'J Type: [Calibrated values
@T Xt Pj Binary
export settings Preset: [csv'. [ Prune::

Delimiter: [omnna Typu:


[LJ
QuoI:ter: [S:nole quote PITT [iiu-und:an

File C:'DurtcomVmagesV1etop 1-24.dot


] Archive Resin:
[Choose.]
[] Delete Res over 7 j days old] Legacy node

The Data area allows the plane and type of data to export to be chosen. Choose the
required plane from those available in the Plane drop-list (choose Red/Grey if the image
is single-plane). Choose the type of data to export using the Type drop-list.
Click the Text radio button to export the data as a spreadsheet, or Binary to export it to a
binary file. If Text is selected, choose the required spreadsheet format from those avail-
able in the Preset list. To export to a custom format, use the Delimiter drop-list (and edit
box if you select Other) to choose the cell delimiter and the Qualifier drop-list to choose
the text qualifier as required.
If Binary is selected, choose the required binary format from those available in the Preset
list, which includes Autosat (if licensed), GRIB (compatible with Synergic) and Cinesat (if
licensed). To export to a custom format, choose the required type for the data using the
Type drop-list and choose the required byte order using the Byte order drop-list.
The file name for the exported data is shown in the File name box, and defaults to that of
the macro's associated image with the 'dat" extension appended. To change the file name,
click Choose... and specify the location and new name for the exported data file in the
Save exported data as window (similar to that shown in figure 3.5).
If you want a rolling archive of exported data files to be maintained, switch on the Archive
tick-box Set the archive path by clicking Choose... and selecting the required folder in
the Archive path window which appears (similar to that shown in figure 3.3).
To delete archived exported data when it exceeds a maximum age (recommended to avoid
the disk filling up) switch on Delete files and enter the required number of days in the
box, or adjust it using the buttons. The minimum is 1 day and the maximum 366.

Ensure that the specified archive period can be accommodated within the
A available disk space. Calculation and experimentation may be required to
determine the appropriate period.

The Legacy mode tick-box should only be switched on if you require the archive folder
structure and naming to be compatible with versions of MacroPro prior to v8.0 (folders
named "Weekly", "Monthly" or "Yearly").
Print settings
Figure 3.50
Tide 21 L.h4yrr legends
The automatic print [Lnrmobon Frequency:
settings Maps and grids degrees
iStation position
Reference points

C ,:s.s_: :a..a. cav.-aa-nas .e a -- znraTr


SOFTWARE MENU REFERENCE
----
L.:6J
-flt;.,rer.___-

The Options area controls the items to include on the printed image. It is equivalent to
the Options area in the Print options window (see Fi1ePrint ... ).

Save settings
Figure 3.51
The automatic save
settings C:5Dartcomage.Vletop 1-2-4copythd Choose.]

To save the processed image with the same name as the original, unprocessed image, click
the Original file radio button.
To save the processed image with a different name to the original image, click the Copy
radio button. The file name defaults to that of the macro's associated image with "copy"
appended to it. To change the file name, click Choose... and specify the location and new
name in the Save copy as window (similar to that shown in figure 3.5).

If the macro's associated image is located on another computer on the


A network, or is updated by its associated image capture system, click the Copy
radio button and specify a location and name on your local computer,
otherwise unexpected results may occur.

Archive settings
Figure 3.52 Path: C:\Dartcom\1na9es\4r &dve Lchoose.i
The automatic archiving 1] Delete files over 7 days old !] legacy mode
settings

Set the archive path by clicking Choose... and selecting the required folder in the Archive
path window which appears (similar to that shown in figure 3.3).
To delete archived images when they exceed a maximum age (recommended to avoid the
disk filling up) switch on Delete files and enter the required number of days in the box, or
adjust it using the Eh buttons. The minimum is 1 day and the maximum 366.

Ensure that the specified archive period can be accommodated within the
A available disk space. Calculation and experimentation may be required to
determine the appropriate period.

The Legacy mode tick-box should only be switched on if you require the archive folder
structure and naming to be compatible with versions of MacroPro prior to v8.0 (folders
named "Weekly", "Monthly" or "Yearly").

Animate settings
Figure 3.53
Maps and gods Lat1on legends
The automatic j Station podSon Frequency:
animation settings iI Reference points jjjJ decrees

Sub-sample level: [1:11Mathnum frames:

g . p 1-2-4.dmd
File name: C:'artcomVma esV 1etu [thoose..j

Use the tick-boxes in the Options area to choose which items to display on the animation
frames. These options are similar to those in the Print options window (see
File .Print ... ).
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
.r2fl.-zrrr rr-es ct

Set the required level Of sub-sampling using the Sub-sample level slider. Sub-sampling
reduces the size of the animation frames. A sub-sample level of 1:1 produces an anima-
tion with frames the same size as the macro's associated image. 1:2 produces frames half
the size of the image, 1:3 a third the size, and so on down to 1:16.
Set the maximum number of frames to keep in the animation using the Maximum
frames box and spin buttons. When the number of frames reaches this limit, the oldest
frame (the first) is removed to make room for the latest. This therefore produces a rolling
animation which shows weather patterns over the past few hours, days or weeks depend-
ing on what limit you set and how often frames are added.

Animations with a large frame size and high maximum frames limit will
occupy a correspondingly large amount of disk space and require a big
display and powerful computer to play them satisfactorily. In general, set the
sub-sample level so the frame size is not larger than your computer's display,
and do not set the maximum number of frames higher than a few hundred.

The file name for the resulting iDAP animation document is shown in the File name box,
and defaults to that of the macro's associated image with the ".dmd" extension appended.
To change the file name, click Choose... and specify the location and new name for the
animation in the Save animation as window (similar to that shown in figure 3.5).

Reproject settings
Figure 3.54 Map option: IEurope
The automatic Base image:
reprojection settings
gte: Fr-

E] Apply mask using colour: JJ


] Recalculate
(destroys any processing applied to Are image)

File tame: c:1partcom'1nro9e&1etop 1-2-4 reproject

Choose the required map option from those available in the Map option drop-list. To
edit or delete the selected map option or add a new one, click Edit.... The Map options
manager (figure 3.36) is displayed. This window is described in NavigationMap
options.... Use it to edit, delete or add map options as required, then select the required
map option and click Close.
To select a base image to be used as the background for the reprojected image, click the
Choose... button. Choose the required image in the window which appears (similar to
that shown in figure 3.1). The file name is then shown in the Base image box. To clear
an assigned background image, click Clear.
The Slice slider allows pixels whose values fall below the specified level, in percent, to be
sliced out of the resulting image. This enables, for example, only cloud cover to be
included in the reprojected image. A Slice value of 0% includes all pixels, and a value of
100% includes no pixels. Experimentation is required to determine a suitable setting for
the Slice slider.
Switch on the Apply mask using colour tick-box if you want the mask defined for the
selected map option (if any) to be applied to the reprojected image and choose the
required colour using the colour picker button.
Switch on the Recalculate enhancement tick-box if you want the projected image to be
re-enhanced to take into account the differing histograms of the original and reprojected
images.
SOFTWARE MENU REFERENCE j 3-69

The file name for the reprojected image is shown in the File name box, and defaults to
that of the macro's associated image with "reprojected" appended to it. To change the file
name, click Choose... and specify the location and new name in the Save reprojected
image as window (similar to that shown in figure 3.5).

-'1 The reproject operation produces a new image document, so the create
palette operation in the same macro will use the unprojected image. To apply
a formula palette to the reprojected version, click the Test button to produce
the reprojected image, then add a new macro for it which performs only the
create palette operation.

Create palette settings


Figure 3.55 Preset: [sea surface temperature product 1
The automatic palette
creation settings (L
Pormula: LMc clanssT c [
- ..... Ursts:

A=t.O8=2,i C=O.5; OO.O; E4.O - -.


lO-catb(4)-catb(5)
ZO-sec(szaO)-L.O
resutt(Acatb(4))+(tD)+(CTOZD)+ZD)4€

Rename: C:\partcomVmagesWetopi-2-4palette.did [Choose..

Choose the required formula palette preset from those available in the Preset drop-list.
These can be created using the Formula palette window (see ProcessingFormula
palette...).
The chosen preset's settings are displayed below the drop-list. If required, you can choose
an alternative formula using the Formula drop-list. The Units box shows the units (if
any) of the formula's result, and the formula itself is shown below the drop-list.
The file name for the resulting formula palette product is shown in the File name box,
and defaults to that of the macro's associated image with "palette" appended to it. To
change the file name, click Choose... and specify the location and new name in the Save
product as window (similar to that shown in figure 3.5).

The reproject operation produces a new image document, so the create


ç-l"t palette operation in the same macro will use the unprojected image. To apply
a formula palette to the reprojected version, click the Test button to produce
the reprojected image, then add a new macro for it which performs only the
create palette operation.

Testing a macro
To test the automatic processing macro for an image document, select the image in the list
on the left-hand side, then click the Test button. When the macro's processing operations
have been completed, click OK and open the processed image document to check the
results are as expected.

To create a macro which performs further processing on a processed image


'' (such as exporting and archiving a reprojected image) it is necessary to first
test the macro which creates the processed image. This image will then exist
and can therefore be added to the current macro set using the Add... button.
=
-7 DARTCOMIDAP/MACROPRO SOFTWARE USER GUIDE

Wj
6*••
Window menu
.......*.......*,$.t*.. . S • ..... S ........ S S S=SS•SSSSSSSSSSS6•S S S 6 6 5 S • SSSSSSSSSSS •

The Window menu provides functions for arranging and selecting document windows in
the MAP or MacroPro application window. In the lower part of the menu, a list of cur-
rently open document windows is maintained, so any which are completely obscured by
other document windows can be selected easily.

LW Cascade

Arranges all currently open document windows in a "cascading" pattern.

W Tile horizontally

Arranges all currently open document windows in a "horizontal tile" pattern.

Tile vertically

Arranges all currently open document windows in a "vertical tile" pattern.

Arrange icons

Arranges the icons of all minimised document windows in a regular pattern in the MAP
or MacroPro application window.
t -. ,,t- .-- —e9mr
SOFTWARE MENU REFERENCE
-o1_.-_- - mt
L3-71 1

1i11 Help menu

The Help menu provides functions for accessing the on-line help system, and for obtain-
ing program information.

:I Help topics
Displays the online help contents page, from which the help system can be browsed.

About...
Displays the version number, date, copyright information and licensed components for
your iDAP or MacroPro installation.
[:3-72] DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE
A-i

APPENDIX

Creating mask files

Introduction S .............
Mask files can be used in the Projection transform window (see Navigationo.
Projection transform... in section 3) to mask areas of a projected image which would
otherwise detract from the clarity of the image. For example, with an SST image it may
be desirable to mask out the land to enhance the clarity of the boundary between land
and sea.
This appendix describes how to create mask files for use when creating projected images.

How to create mask files


S. .S.a*,o.,.e es Set.... •5S • Sea StC*øt** S•ee*sStS to....n. tt,,.*.. SS*S• S • •SSt •SS*SCS*SS

Each map option can have a different mask file associated with it. The instructions below
describe how to create a mask file for one map option.
0 From within DAP, select NavigationProjection transform... to open the
Projection transform window. Set up the map overlay for the desired
projection and area of coverage. It is advisable to switch off all overlays
except coast outlines, and to make the coast outlines white. This greatly
simplifies the mask creation process.
o Without clicking Transform, click Save as.... Enter a name for the image
(Maski for example) and click Save. Close the Projection transform
window.
O The image you just saved should open automatically. If not, open it using
FiIe'Open....
O Select File .Exportlmage... to open the Image export options window.
In the Options area, ensure all check boxes are switched off except Maps
and grids, which should be switched on. In the Format area, change the file
format to TIFF and ensure that Reduce to 8-bit is switched on. Click OK to
export the image and save it with the default name (Maski .tif).
[A-2J DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE

o Open the image just exported (should be titled Maskl.tif) in an image


processing package such as Adobe Photoshop or Paint Shop Pro. Reduce
the number of colours to 2 (bitmap mode).
o Examine the coast outlines to check that they all join up where appropriate,
and that they reach to the edges of the image.
O Fill all the areas you don't want to be masked out white. Leave all areas
which you do want to be masked out black. This may require additional
applications of step 0, and you may need to zoom in and manually paint
small areas such as lakes or inlets.
o Save the finished mask as a 1-bit TIFF using the same name as before.
o Rename the saved file to <map option name>.msk, where <map option
name> is the name of the map option with which you want to use the mask.
Move the renamed file into the %AppData%\Dartcom\iDAP\Map options
folder. Remove the temporary mask files created earlier in this process.
The mask can now be used with the chosen map option. As long as the
projection settings for the map option are not changed, you can apply the
mask to projected images to obscure unwanted areas. You can, however,
change the overlays and colours without affecting the mask.
B-i

A P P E N D I X

Formula programming
L!L
Introduction
0 • S S S S St. S 5 S S 8 0 8 8 0 0 0 0 3 0 0 0 0..........
3 0 S $ S S S * • * 0 0 S S S S S S S S S S • S C S S 0 0 8 0 • * • S 0 0 • S S S 5 5 5 5 * • S

This appendix describes how to write formula for use in the Formula palette window
(ProcessingFormula palette...). Programming guidelines and a complete function
reference are provided.

Language syntax
8000.,*,000S.,....0*.sp.08888-o.,, 8a..e.gsnq,t,p0ot

Formula components
A formula consists of one or more lines. Each line can contain statements or comments.
Statements are made up of expressions. Expressions are made up of literals, constants,
variables, operators and functions. Blank space (spaces, new lines and tabs) can be used
between any of these components to format the formula as required.

All formula components are case-sensitive, which means that lower-case


/ letters are treated as being different to upper-case.

Statements
Each line of a formula can contain one or more statements. A statement takes the follow-
ing form:
<variable>=<expression>[; :
The delimiter (a semicolon or colon) is optional if there is only one statement on a line.
However, if there are multiple statements on a line, a delimiter must be included between
each statement.
The following are examples of valid statements or sequences of statements:
a=sin(x)
b=raw(4); c=calib(5): d=latitude()
DARTCOM IDAP/MACROPRO SOFTWARE USER GUIDE

The last line of each formula must contain a statement which assigns a value
" to a variable called "result': The value of this variable is used as the formula's
result after the formula has been evaluated.

Comments
Comments can be used to describe how the various stages in a formula work. They are
purely for your reference and are ignored when the formula is evaluated. Comments
cannot be spread over multiple lines of the formula. A comment must be preceded by one
of the following delimiters:
II
rem

The formula below contains examples of valid comments:


rem A demonstration
formula
a=dtor(imagex()) II Get x co-ordinate in radians
b=dtor(imagey) II
Get y co-ordinate in radians
result=sin(a)+sin(b) Calculate result

Expressions
An expression is a combination of literals, constants variables, operators and functions
which, when evaluated, produces a single, numerical result.
The following are examples of valid expressions:
5.7
a
raw( green)
(a+b+c)*(e+f)*tan(g)
sec (sza())

Literals
A literal is a value which is expressed in numerical form. The following are examples of
valid literals:
128
24.92
—6.04

Constants
A constant is a reserved word which has a fixed value associated with it. The value of a
constant cannot be changed. A constant cannot be assigned to a variable or operated
upon. Table B. 1 lists the constants currently defined.
FORMULA PROGRAMMING rBj
.0 -i- -•' - - -- Mfl6 y S;-- ______________ __________ -. -

Table B 1 Constant 1[Descripóntt -


Reserved formula
constants iB_ JES3.145926535892_

[green
[Tj
rey plane ofasinglene image
Re d pla ne fa multi-plane imge
jenlie ofamulti-planerriae
Blue plane of a[làne mge 1

Constant names must be typed exactly as they appear in table B.1, because
" they are case-sensitive.

The following statements contain examples of valid uses of constants:


result=raw( grey)
result=calib(blue)
The following statements contain examples of invalid uses of constants:
a=green
p1=8.494
result=sin(x)+blue

Variables
A variable is a means of storing the result of an expression for use in subsequent expres-
sions. Each variable must have a unique name which is not reserved. The name must
start with a letter, which can then be followed any of the characters below:
'1'..'9' ''..'Z', 'a'..'z',

Ensure that you type all occurrences of a variable exactly the same, because
/ they are case-sensitive.

The following are examples of valid variable names:


a
C'
xy6_P25
fruitcake-7
The following are examples of invalid variable names:
z
5_golden_rings
grey

Variables are declared automatically when they appear on the left-hand side of an assign-
ment. Variables cannot appear in expressions unless they have been declared in a previ-
ous statement in this way.

The last line of each formula must contain a statement which assigns a value
do))) to a variable called "result' The value of this variable is used as the formula's
result after the formula has been evaluated.
8-4 DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE

The following formula contain examples of valid uses of variables:


a=sza()
A=a-(pi/2)
result=tan(A)
c=calib(4)
d=calib(5)
result=c-d
The following formul contain examples of invalid uses of variables:
zenith=sza()
plane=grey
raw=raw( plane)
result=sin(x)
a=a
result=pow(b,2)

Operators
The standard mathematical operators (+, , I) are provided for use in expressions.
Operators are evaluated in left-to-right order. Operator precedence is also employed,
which is as follows (in descending order of precedence):
( )

As an example, take the statement below:


result=(a*b+cld_e) /f*g
This would be evaluated as follows:
result=((((a*b)+(cld)_e)/f)*g)
Unary plus and minus operators are supported so, for example, the following are valid:
-6.2
+2.0
—sin(a)

Functions
A function is a special type of operator which takes zero or more comma-separated argu-
ments and returns the result of a calculation involving the arguments. Functions take the
following form:
function( [argument] [, ][argument][,]...)
An argument can be a literal, a variable or an expression. Some special functions can take
constants as arguments.
The following formula contains examples of functions and valid uses of them:
a=sza()
b=tan(a-(pi/2))
result =pow(b, 2)
The following formula contains examples of invalid uses of functions:
sza( )=5
result =cos (red)
4- . r SLY 4..4-- t_- .. -
FORMULA PROGRAMMING
-r.-__ 4E
LB-5
W'4-4t,-^ S

The range of available functions is described below.

Function reference
a. .................,a,.**,,,..*................... ...........
General functions
abs(a)
Returns the absolute (unsigned) value of a. For example, abs(-6.4)=6.4.

int(a)
Returns the integer truncation of a. For example, int( 1 .56)= 1.

div(a,b)
Returns the result of the integer division a--b. For example, div( 11 ,3)=3.

mod(a,b)
Returns the remainder of the integer division a--b. For example, mod(11,3)=2.

Trigonometric functions
sin(a)
Returns the sine of a, which must be specified in radians.

cos(a)
Returns the cosine of a, which should be specified in radians.

tan(a)
Returns the tangent of a, which should be specified in radians.

sinh(a)
Returns the hyperbolic sine of a, which should be specified in radians.

cosh(a)
Returns the hyperbolic cosine of a, which should be specified in radians.

tanh(a)
Returns the hyperbolic tangent of a, which should be specified in radians.

sec(a)
Returns the secant of a, which should be specified in radians.

cosec(a)
Returns the cosecant of a, which should be specified in radians.

cot(a)
Returns the cotangent of a, which should be specified in radians.

asin(a)
Returns the arcsine (inverse sine), in radians, of a.

acos(a)
Returns the arccosine (inverse cosine), in radians, of a.

atan(a)
Returns the arctangent (inverse tangent), in radians, of a.
F B-6 I DARTCOM iDAP/MACROPRO SOFTWARE USER GUIDE

atan2(a,b)
Returns the arctangent (inverse tangent), in radians, of a+b.

Trigonometric conversion functions


rtod (a)
Returns a converted from radians to degrees.

dtor(a)
Returns a converted from degrees to radians.

Power functions
exp(a)
Returns the exponential of a.

log(a)
Returns the natural logarithm of a.

log 0(a)
Returns the base 10 logarithm of a.

pow(a,b)
Returns a raised to the power b.

sqrt(a)
Returns the square root of a.

Image functions
pixel(n)
Returns the pixel value of a plane or channel for the image point to which the formula is
being applied. To obtain the pixel value from an image plane, n must be a plane constant
(grey, red, green or blue). To obtain the pixel value from an HRPT, CHRPT, AHRPT or
DMSP channel, n must be a channel number (1-10). The result will be in the range
0-255.

raw(n)
Returns the raw value of a plane or channel for the image point to which the formula is
being applied. To obtain the raw value from an image plane, n must be a plane constant
(grey, red, green or blue). To obtain the raw value from an HRPT, CHRPT, AHRPT or
DMSP channel, n must be a channel number (1-10). The result will be in the range
0-1023.

calib(n)
Returns the calibrated value of a plane or channel for the image point to which the
formula is being applied. To obtain the calibrated value from an image plane, n must be a
plane constant (grey, red, green or blue). To obtain the calibrated value from an HRPT,
CHRPT,AHRPT or DMSP channel, n must be a channel number (1-10). The range of the
result will depend upon the type of calibrated data (albedo or temperature) on the plane
or channel.

sza()
Returns the solar zenith angle, in radians, for the image point to which the formula is
being applied.
FORMULA PROGRAMMING 1B-7

saa()
Returns the solar azimuth angle, in radians, for the image point to which the formula is
being applied.

latitude()
Returns the latitude, in degrees North of the equator (0 ), for the image point to which the
formula is being applied.

longitude(
Returns the longitude angle, in degrees West of Greenwich (0), for the image point to
which the formula is being applied.

nadir()
Returns the angle from nadir, in radians, of the image point to which the formula is being
applied.

inclin()
Returns the satellite inclination, in radians, for the image point to which the formula is
being applied.

imagex()
Returns the x co-ordinate of the image point to which the formula is being applied.

imagey()
Returns they co-ordinate of the image point to which the formula is being applied.

Temperature conversion functions


ctof(a)
Returns a converted from degrees Centigrade to degrees Fahrenheit.

ftoc(a)
Returns a converted from degrees Fahrenheit to degrees Centigrade.

S-ar putea să vă placă și