Documente Academic
Documente Profesional
Documente Cultură
iDAP/MACROPRO
INTEGRATED DISPLAY AND PROCESSING SOFTWARE
FOR SATELLITE IMAGERY AND METEOROLOGICAL
DATA WITH AUTOMATIC MACRO PROCESSOR
\;
- 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
1 Overview
Introduction to iDAP .1-1
Introduction to MacroPro..................................................................................................1-2
Directorystructure............................................................................................................1-2
4erciice.*
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- - --- -
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.
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.
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.
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.
Figure 2.2
An example of a fax
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
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.
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.
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
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.
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.
SECTION
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.
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.
Save as...G-ii
Functions which are available only in MacroPro are identified by a small MacroPro icon,
as in the example below.
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' '
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.
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]
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
P^
0 1128 256 384 512 640 718 596
Saberample
p
1:1 1:32
Size
Width: 0 foods . Selecta6
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
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.
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.
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.
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.
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....
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.
rF, Close
Closes the active document window. Equivalent to clicking in the title bar of the
document window.
SaveG-n
Saves the active document using its current name, updating the copy currently on disk.
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.
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.
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
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.
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)
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.
- 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.
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).
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.
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
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.
2
LJ Raw
JCaibrated
Swathe:
© As ingested (55.4500')
55.50lD0T,
J Addilonal data
'lap option
[Earope
.H[t... Q
j Show overlays
5 j Show overlays
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.
• 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.
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.
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
-- -.- ..................................... . - . - - - - -
-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.
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)
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
(]Show overlays
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.
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.
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.
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.
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.
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
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....
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....
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.
-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....
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
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.
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
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.
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.
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....
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.
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
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.
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
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 ..*
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.
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.
Set magnification...)
Choose the new magnification level from the New magnification drop-list, then click OK
to apply it to the active image.
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.
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
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
-
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.
cj f tfinorao "I
EE Show profile on graph
Preset
•-0
1S.v1 1inte1
U---------------- Co Alyoutomeficolly
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.
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.
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
Colours
-:
L'-
[$j
Colour: pg mode: [glel_Graduated !iuse ASs colour for values larger than lost
01 181_uij
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.
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
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.
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.
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.
Edit calibration...
Allows the constants used to calibrate the active image to be edited. The Calibration
editor window (figure 3.25) is displayed.
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.
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.
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.
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.
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.
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.
Figure 3.32
The Projection Map opbon
Show overlays
Ease image
Image processing
Slice:
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.
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.
F-]
httu:jfearthobserv,tar y , yusa,cuvRqewsruomueMurble for details.
Icanc L...°..
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.
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.
Applu L Cancel OK j
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.
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.
To keep the mask applied to the image, click OK, or to restore the image before the mask
was applied, click Cancel.
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
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.
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....
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.
Figure 3.38
The Dartcom Overlays Import overlay from text file
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.
The Configuration
window (Utilities Details
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.
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
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
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.
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
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
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.
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.
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.
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.
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.
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.
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: -
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.
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:. -
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
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).
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
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-
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.
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).
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.
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
W Tile horizontally
Tile vertically
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
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
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.
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
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.
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
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;-- ______________ __________ -. -
[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.
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.
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
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):
( )
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
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.
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.
ftoc(a)
Returns a converted from degrees Fahrenheit to degrees Centigrade.