Raster Importer

The Raster Importer (rast_imp) is the mechanism that converts NIMA raster data from its distribution format into a format that other NIMAMUSE program scan use, and also into formats that commercial software uses. The Raster Importer can also convert several international raster formats.

The Raster Importer is easy to use, and the choices you make during its use are dictated by the raster product that is your input, and by the programs that will eventually use the raster product. Once your choices have been made, the Raster Importer will create your new digital image, ask you to name it, ask you to assign a format type, then save it to your disk drive as a file.

NIMA Raster products are distributed to users in formats intended to facilitate distribution and storage, and not necessarily intended to facilitate the processing that you want to do. But applying the NIMAMUSE Raster Importer to your NIMA data over the geographic area that you are interested will get you ready for your target processing.


Raster data is a rectangular array of values which represents a picture. An array of elevation values is also considered raster data. The diagram below shows how a shades of gray picture of the U.S. border can be represented as raster data.


Can NIMAMUSE convert my NIMA digital map data?

Once you have determined that you need to have your NIMA digital raster map data converted to a required format, you now ask "Can the NIMAMUSE Raster Importer convert my NIMA digital map data?"

The following tables answer this question. First, find the table that matches your hardware platform (UNIX or PC/Windows). Then, in this table, find your NIMA raster product on the top row and your target out put format along the left side. If there is a table entry corresponding to this product-format pair, then you can convert your product to this format. (Watch out for crosshatched cells which mean ineligibility.) Note that the table entry itself is listed the default filename extension you get after you perform the data conversion. It is recommended that you accept these defaults when using NIMAMUSE.

Included in UNIX platforms are these systems:

- Sun (both Solaris 2.x and SunOS)

- Hewlett Packard

- Silicon Graphics

----------------------------------------------------------------

Included in PC platforms are PC's running:

- Windows 95

- Windows NT

- Windows 3.11 (must be running Win32s compatibility mode)

- Windows 3.1 (must be running Win32s compatibility mode)

----------------------------------------------------------------

The Raster Importer Session

Every Raster Importer session can be viewed as having three major "session" steps:

1. identify your input product AND choose your geographic area definition method

2. answer input product-specific and method-specific questions

3. choose your target output format(s)

The details of these three session steps will follow in the sections below. You will have to make decisions and choices based on the NIMA product that you are importing, and on the output format you choose.

Some Preparation Before You Import

* Geographic Area Definition Methods

There are four geographic area definition methods. Your choice of one of these four methods will be based how you are using the data once imported:

1. Center Point, Zoom, and Image Extents (pixels): here, you are primarily concerned with visual quality and the size of the resultant file.

2. Geographic Extents and Zoom: here, you are primarily concerned with geographic coverage and visual quality.

3. Geographic Extents and Image Extents (pixels): here, you are primarily concerned with geographic coverage and the size of the resultant file.

4. Raster File: for co-registration with existing file, which must be a NIMAMUSE Raster file. This method is very handy for NIMAMUSE specialty applications Line of Sight and Perspective Scene

* The "muse.ini" file

This file is a place were NIMAMUSE saves application settings and parameters. The Raster Importer has a section within this file, and you will be asked if you want to use settings in this file and if you want to save your current settings to this file for future use.

* Interpolation

Sometimes it will be necessary to interpolate pixels of the data you are importing for the products that Raster Importer inputs. If applicable to your data, you will have a choice among interpolation methods. The following table identifies the applicable interpolation methods for each product:

----------------------------------------------------------------

Session Steps by Product

Session Step 1 - Identify your input product AND choose your geographic area definition method

For All Products

A. Choose your input product:

NIMA:  ADRG, ADRI, CIB, CAC, CADRG, DBDB5, DBDBV, DTED

International:  USRP, ASRP, SRG, CRP, NORDIC


B. Choose your geographic area definition method:

1. Center Point, Zoom, and Image Extents

2. Geographic Extents and Zoom

3. Geographic Extents and Image Extents

4. Raster File


Session Step 2 - answer input product-specific questions

ADRG

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

d1. Choose interpolation: nearest neighbor or.

d2. Choose output type: 8-bit or 24 bit.

e. Choose Transmittal Header File (*.thf) from input (use a File Selection Box)

f. View Status Update Box (progress in %complete).

ADRI

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

d. Choose interpolation: nearest neighbor or bilinear.

e. Choose Transmittal Header File (*.thf) from input (use a File Selection Box)

f. View Status Update Box (progress in %complete).

CIB

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e1. Choose RPF/A.TOC file (Raster Product Format Table of Contents file)from input (use a File Selection Box).

e2. Choose RPF Map Series.

f. View Status Update Box (progress in %complete).

CAC

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e. Choose cd_id.dat from input (use a File Selection Box -- look under the "/cd" directory on the data CD-ROM).

f. View Status Update Box (progress in %complete).

CADRG

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e1. Choose RPF/A.TOC file (Raster Product Format Table of Contents file)from input (use a File Selection Box).

e2. Choose Color Table (216, 32, or 16).

f. View Status Update Box (progress in %complete).

DBDB5

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e. Choose BATH. from input (use a File Selection Box).

f. View Status Update Box (progress in %complete).

DBDBV

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e. Choose DATA. from input (use a File Selection Box).

f. View Status Update Box (progress in %complete).

DTED

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e1. Choose DMED. file from input (use a File Selection Box).

e2. Enter number for 'NO DATA' elevation value (default = -32767). You may want this value to be ZERO if 'NO DATA' means 'ocean'.

f. View Status Update Box (progress in %complete).

ASRP (British)

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e1. Choose Transmittal Header File (*.thf) from input (use a File Selection Box)

e2. Choose product by scale from the DGIWG Scale Selection Box

f. View Status Update Box (progress in %complete).

USRP (French)

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center Easting and Northing, UTM Zone & UTM Zone Area (N or S), zoom factor, and number of pixels in both the X and Y direction.

2. Enter left Easting, right Easting, top Northing, bottom Northing, UTM Zone & UTM Zone Area (N or S), and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left Easting, right Easting, top Northing, bottom Northing, UTM Zone & UTM Zone Area (N or S), and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e. Choose Transmittal Header File (*.thf) from input (use a File Selection Box)

f. View Status Update Box (progress in %complete).

SRG (Italian)

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center Easting and Northing, UTM Zone & UTM Zone Area (N or S), zoom factor, and number of pixels in both the X and Y direction.

2. Enter left Easting, right Easting, top Northing, bottom Northing, UTM Zone & UTM Zone Area (N or S), and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left Easting, right Easting, top Northing, bottom Northing, UTM Zone & UTM Zone Area (N or S), and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e. Choose Transmittal Header File (*.thf) from input (use a File Selection Box)

f. View Status Update Box (progress in %complete).

CRP (British)

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e1. Choose Transmittal Header File (*.thf) from input (use a File Selection Box)

e2. Choose product by scale from the DGIWG Scale Selection Box

f. View Status Update Box (progress in %complete).

NORDIC (Danish)

a. If you are using method 1 (Center Point, Zoom, and Image Extents), you can choose to get previously saved geographic area definition parameters from either the Importer section or the Fusion section of the muse.ini file. Methods 2 & 3 will automatically get these parameters from the Importer section. Method 4 gets the parameters from the raster file itself.

b. Define Area of Interest Box:

1. Enter center latitude/longitude, zoom factor, and number of pixels in both the X and Y direction.

2. Enter left longitude, right longitude, top latitude, bottom latitude, and zoom factor. (The number of pixels in both the X and Y direction are NOT specified, but rather calculated based on parameters entered in this box).

3. Enter left longitude, right longitude, top latitude, bottom latitude, and the number of pixels in both the X and Y direction. (The zoom factor NOT specified, but rather calculated based on parameters entered in this box).

4. Choose a NIMAMUSE Raster File upon which to base your extraction (use a File Selection Box)

c. Choose yes/no: save the geographic area definition parameters to importer section of muse.ini?

e1. Choose *.IT file from input (use a File Selection Box)

e2. Choose product by scale from the IT Scale Selection Box

f. View Status Update Box (progress in %complete).

Session Step 3 - choose your target output format(s)

For All Products

g. Image or Data Output Format Selection -- choose among many output types(see input vs. output table for each platform) - click OK

h. Specify output filename (use a File Selection Box).

i. Image or Data Output Format Selection -- click Finished (or repeat steps g, h & i to save data in an additional format).

Raster Importer Application Reference and Tutorials

See the Raster Importer Users Guide for more details and for tutorials: RAST_UG.DOC

Examples of the Define Area of Interest Box:

Method 1: Center Point, Zoom, and Image Extents

Method 2: Geographic Extents and Zoom

Method 3: Geographic Extents and Image Extents


---------------------------------------------

Related NIMAMUSE Documents

Raster Importer Users Guide  RAST_UG.DOC

Vector Importer   VPF_IMP.DOC

Vector Importer Users Guide  VPFI_UG.DOC

Fusion   FUSION.DOC

Fusion Users Guide   FUS_UG.DOC

Access and Prepare NIMA Digital Data  APNDD.DOC

Build Your Own Map   BYOM.DOC

Run Specialty Applications   RSA.DOC

NIMAMUSE 2.1 Documentation   INTRO.DOC