Content-type: text/html Manpage of MAPSMERGE

MAPSMERGE

Section: Misc. Reference Manual Pages (1L)
Updated: 3 Mar 1992
Index Return to Main Contents

NAME

mapsmerge - merge multiple maps into 1 map (real*4 maps) (ao)

SYNOPSIS

mergemaps -f filelist -c numcols -r numrows -h mapsperrow -z

DESCRIPTION

mapsmerge is a program to merge mulitple maps into a single map. The merged map will have mapsperrow maps horizontally in a row and (nummaps + mapsperrow -1)/mapsperrow maps vertically. Any slots at the end with no data are zero filled. The map files are real*4 data stored in row major order (stored by rows).

The input map filenames are listed in the file filelist with 1 filename per line. Each map should be numrows by numcols and contain real*4 data.

The program reads all the maps into memory, and then outputs one row at a time. The output is written to standard output.

The merged map can be converted to a byte/pixel map with scaleto8bitsr and from a byte/pixel map to sun raster format with map8bittorf.

OPTIONS

-f filelist: This file contains the names of the maps to combine. There should be 1 map name per line. The maps will be placed in the output file in the same order as they are listed in this file.
-c numcols: The number of horizontal pixels in each input map.
-r numrows: The number of vertical pixels in each input map.
-h mapsperrow: Place mapsperrow maps horizontally across the output map.
-z: Place a line of zeros to the right and below each input map.

EXAMPLES

Suppose there are 10 input maps that are each 100 (hor) by 200 (ver) pixels of real*4 data with file names mapf1 thru mapf10. Place the 10 filenames mapf1 thru mapf10 1 per line in the file junkfile. Let the output file be called map.out. If we want 3 files horizontally in the output map and a line of zeros between each map we could use:

: mapsmerge -f junkfile -c 100 -r 200 -h 3 -z > map.out
: The output would be 303 by 804. The last two maps on the bottom row would be filled with zeros.

The above map could be converted to a sun raster file map via:

: scaleto8bitsr -s min -b max -i < map.out|map8bittorf -c 303 -r 804 > map.ras
: Here min,max are the min,max values in the file and -i says to scale to 1-200 so the map can be displayed with imtool (of iraf fame).

FILES

~phil/util/filters/mapsmerge.c location of source code

BUGS

Need to write i1tor4 and r4toi1 so you can use this program can also be used on 1 byte/pixel data.

This document was created by man2html, using the manual pages.
Time: 21:00:09 GMT, November 03, 2010