bigmap

Description

This procedure creates a large topographical/albedo map with the same file structure as a maplet.

The location of the map center is specified by one of three choices:

p - pixel/line location in a picture
l - latitude and west longitude
m - pixel line location in a bigmap or maplet

A second set of inputs contains:

the bigmap scale in km/px
the half-size (qsz)
an integer random seed
a maximum maplet scale in case lower resolution maplets are to be excluded

The program first determines the body-fixed vector to the map center and the approximate surface normal vector (Uz). It then projects the shape model onto this surface and determines a second approximation of Uz by fitting a plane to the heights. It repeats this process one more time. The new map coordinate frame is then oriented so that East is to the right.

The program checks to see if any these files exist:

BIGMAP.IN
LMRKLISTR.TXT
LMRKLIST.TEXT

It takes the maplets to be used from the first of these files that it finds.

If LMKLX=.TRUE. in INIT_LITHOS.TXT, bigmap will read LMRKLISTX.TXT. This will speed up the program by determining which maplets will be used without opening their .LMK files.

ORIGINAL: The maplets to be used in the construction are taken from the first of the files

BIGMAP.IN, LMRKLISTR.TXT or LMRKLIST.TXT found to exist. However, if LMKLX=.TRUE. in the INIT_LITHOS.TXT file, the program will read LMRKLISTX.TXT. If there are a great many maplets, the latter choice will speed up the procedure by determining whether a maplet needs to be used without having to open its .LMK file.

The bigmap reference plane has (2*qsz+1)^2 points at locations:

p(i,j) = V + j*Ux +i*Uy   (i,j = -qsz,qsz)

A line from each of these points in the normal (Uz) direction will pierce a number of maplets. For each i,j the program keeps track of:

the weighted accumulation of the heights to the piercing points
the squares of those heights
the slopes and albedos of the maplets at the piercing points

Once these arrays are filled, bigmap computes the average heights and albedos at each point of the reference plane, as well as the standard deviation of the heights. This provides a convenient measure of the height uncertainty at each point. Displaying SIGMAS.pgm provides a quick means of identifying possible problem areas.

Required Files

LMKFILES/ - Directory of .LMK files for each maplet.
LMRKLIST.TXT - Required. List of landmarks.
MAPFILES/ - Directory of .MAP files.
SHAPEFILES/ - Directory of built shapes.
BIGFILES/ - Directory of .LMK files for each of the required bigmaps. This directory must be created, but changes are made within.
SUMFILES/ - Info about the maplets. Many files must be unique. All directories can be linked to a master.

Optional Files

BIGMAP.IN - A list of landmarks that you want to use for bigmap. This file allows you to reduce the number of files and avoid low resolution images.
LMRKLIST.TXT - Same as above, but only used if BIGMAP.IN is missing (used for historical purposes). If neither of these files exists, the program will build the list of files that are included in the coverage.

Output Files

INSIDE.TXT - The maplets that fall completely within the planned bigmap. Created by bigmap.
USED_MAPS.TXT - All the maps used to create the bigmap.
BIGLIST.TXT - List of needed mapfiles (bigmaps) used to construct the working bigmap.
USED_PICS.TXT - List of all pictures used in the creation of most recent bigmap.
bigmap - The name is based on the input (e.g., ZN0208.IN).
slope.pgm - Image that shows the slope in both horizontal and vertical.
SIGMAS.TXT - Each time BIGMAP is run, it adds a line to this file showing the current sigma values.
SIGMAS.pgm - Graphically shows the highest level of error (sigma) for maplets.

Using bigmap

The input for bigmap consists of a long set of commands that are usually contained within a file what is file name??

$/!\$ Longitude is in west longitude. You must use a negative to match what is used in spheremapB.e.
$/!\$ The location of bigmap depends on your server. The default location is /usr/local/bin

Here is a sample input for bigmap:

 ~/bin/bigmap < ZN0208.IN

The following sample shows the normal format for the input file what's it called??:

l   (select location, 1 is lat/lon)
    20    -40    (latitude, west longitude)
   0.06250       500   1.23400   1000  (scale, qsz (number of pixels), seed, max maplet res) 
ZN0208           (filename)
1                (end or integrate, 1 is integrate)
.005             (input fraction)
.025             (input weight)
1                (end, continue, or change weight, 1 is continue integrating)
0                (end, continue, or change weight, 0 is end iteration)
0                (no, square, or round template, 0 is No Template)
1                (end, continue, or change weight, 1 is continue integrating)
1                (end, continue, or change weight, 1 is continue integrating)
1                (end, continue, or change weight, 1 is continue integrating)
1                (end, continue, or change weight, 1 is continue integrating)
1                (end, continue, or change weight, 1 is continue integrating)
1                (end, continue, or change weight, 1 is continue integrating)
0                (end, continue, or change weight, 0 is end iteration)
0                (no, square, or round template, 0 is No Template)

Here is a sample of sigmas.pgm:

(Compiled by TC)

CategoryPrograms