CLIP: Cuts and samples parts of images and changes scale of B/W images for IMVIS mapping. Reads an 8 bit image and (1) clips and/or samples it as is, (2) rescales a b&w image from 0 - 63 and makes a color table from 64 - 255 with 6 reds, 8 greens and 4 blues Command Line: clip [infile] [irw][icl] [outfile] [rw1][cl1] [orw] [ocl] [sample] [/iop] where: infile = input file name with extension irw = number of rows in input image icl = number of columns in input image outfile = output file name without extension rw1 = first row in input image to use in output image cl1 = first column in input image to use in output image orw = number of rows in output image ocl = number of columns in output image iop = /1 for clip and sample: /2 for grey scale compression to 64 and color above --------------------------------------------------------------------------- CLIP_LBS: Reads an 8, 16 or 32 bit image and clips and/or samples it making another image which can be used by program TRIGRID. Command Line: clip_lbs [infile] [outfile] [rw1] [cl1] [orw] [ocl] [sample] where: infile = input file name without extension outfile = output file name without extension rw1 = first row in input image to use in output image cl1 = first column in input image to use in output image orws = number of rows in output image ocls = number of columns in output image sample = sample rate ( 1 for full data ) path = path where data file can be found (optiona) Example: clip_lbs e_coast va 100 200 1000 1000 10 L:\GLOBE\ This will start at row 100 and column 200 and make a 100x100 pixel image from the 1000x1000 pixel sub image in described in file 'E_COAST.LBS'. --------------------------------------------------------------------------- DIGIT : Uses the GTCO SketchMaster digitizing tablet. Creates an ASCII .XYC file containing xy points of linework. Place map on palette and enter 'digit'. Button Control Line Colors /\ 1 = red / 1 \ 2 = orange / ENTER \ 3 = yellow / & \ 4 = green / \ SAME COLOR /\ 5 = d_green / 2 \[yellow] / 4 \ 6 = vd_green / \ / \ 7 = blue / \ / \ 8 = cyan \ CLOSE / \ END / 9 = d_cyan \ [white] / 3 \[green] / 10 = d_grey \ / \ / 11 = m_grey \ / NEW \/ 12 = l_grey \ COLOR / 13 = white \ [blue] / 14 = l_buff \ / 15 = buff \/ Orientation: l -- plot lines and make an '___.xyc' file -- north up L -- plot lines and make an '___.xyc' file -- north to right --------------------------------------------------------------------------- DLG2RAW : Creates a set of RAW files, one layer at a time, for use in the MAPPER mapping package from the DLG 7 1/2 or 15 minute quads from the 100K CD-ROM digital data series. This program uses files transferred from the 100K DLG disk, the output from program DLGSORT run on these files and a control file for the layer being processed. HY -- Hyro (rivers, lakes, islands etc.) RD -- Roads (roads, trails, ferry crossings, bridges, etc.) MT -- Misc. Transportation (airports, pipelines, etc.) RR -- Railroads You chose a two-character identifier for each set (frequently the state ID) and it does the rest. This program makes a series of files which may have up to 99 of one type. Each RAW file can contain only 9000 line segments and after each is filled the last to digits of the file name are in- cremented by one and a new file is started. The file with the most segments is usually RD4 which is the town and residential streets. For the state of Pennsylvania this will range from PARD401.RAW to PARD448.RAW. PARD448 --> PA RD4 48 [id] [type] [sequence number] Since RAW file will be added to those already in the directory it is a good idea to remove all RAW file in the directory before running the program. To do this enter : del *.raw Command Line: dgl2raw Comments: Use REORDER to prepare files for viewing and MAPPER to view these files. --------------------------------------------------------------------------- DLGSORT : Sorts DLG 7 1/2 or 15 minute quads from the 100K CD-ROM data series by latitude and longitude of the NW corner. This program creates a file named '15min.txt' which is used by program DLG2RAW to make lat/lon RAW files from the optional format UTM DLG files. Use the software on the100K DLG data disk to off load one layer of data for the area you wish to process. These DLG files have no file type so the directory in which you are working must contain no other files with no type. Before transferring the DLG files from the CD-ROM it is a good idea to enter: del *. Command Line: dlgsort --------------------------------------------------------------------------- EIGEN : Makes eigen vector (principal component score) images of multi spectral data. Command Line: eigen [filename] You must give a file name without a type and there must be file of type '.lbl' of that name. The minimum information needed in the label file is as follows: FILE_TYPE = IMAGE IMAGE_LINES = 400 LINE_SAMPLES = 640 SET_POINTER = 6 canonb1.dat 0 255 canonb2.dat 0 255 canonb3.dat 0 255 canonb4.dat 0 255 canonb5.dat 0 255 canonb7.dat 0 255 END The 0 and 255 mark the maximum and minimum values which will be conside- red as data. Values outside this range will be considered to be missing. If any value is missing the entire point is missing. You may have three values for 3 point scaling, in which case the first and last will be assumed to be the data range. --------------------------------------------------------------------------- ETOPO5: Reads the ETOPO5 5 minute elevation model of the earth and creates WVF (Wave Front X,Y,Z) files in various projections and forms. Output is from a lat/lon rectangle and can be sampled to any density. Input data is file 'GLOBE16.DAT' which can be found on US Geological Survey Open File Report 93-231 -- Data, Software, and Applications for Education and Research in Geology CD-ROM. Command Line: etopo5 Example: etopo5 l:\3d\ Which processes L:\3D\GLOBE16.DAT from the Virginia CD-ROM. Options: Make a sub image in Wave front format: 1 -- round earth (part of a sphere) 2 -- flat/solid (plate carree projection with flat bottom) 3 -- flat/skin (plate carre projection with thickness) 4 -- image set -- flat/solid (set of files with same plate carree projection with flat bottom) 5 -- image set -- flat/skin -- projected (set of files with same pro- jection with thickness) 6 -- make a sub set for 'trigrid.c' a -- check max min of set x -- exit program\n Output can be viewed with program WAVE if WAVEPREP is used first. --------------------------------------------------------------------------- FILTER: Filters RAW files so that points are a least a set number of kilometers apart. Also cuts line segments to size by number of points. Command Line: filter [filename] [spacing_id] Example: filter track 1 /c 100 /b Filters 'track.raw' to 10 km and makes 'tracka.raw' with no vector longer than 100 points and '/b' means brief. No status will be printed and it will run faster. Spacing: Spacing ID File Prefix Spacing (km) ---------- ----------- ------------ 1 0 100.0 2 A 10.0 3 B 1.0 4 C 0.1 5 D 0.01 6 E 0.001 --------------------------------------------------------------------------- IMVIS: View and makes color and grey scale images as well as makes XYC files for map making. Command Line: imvis Options: (1) /m [menu.fil] -- menu of file .LBL names and text for identification. Where 'mnu.fil' can be any file name and type. Menu File Format: Header file1.lbl Description of file 1 (40 or < char) file2.lbl Description of file 2 (40 or < char) file3.lbl Description of file 3 (40 or < char) etc. Example: Geologic Images: fig01.lbl Southern bank of the Potomac River fig07.lbl Mary Washington Monument, Fredericksburg fig23.lbl Prince William Forest Park (2) /o [name.lbl] -- Processes one image named after '/o'. (3) scan -- Displays all images in file for 3 seconds. Screen Screen Number of Width Heigth Colors ------- -------- ---------- (4) /X -- 640 480 256 (5) /Y -- 640 400 256 (6) /S -- 320 200 256 (7) /V -- 640 480 16 (8) /E -- 640 350 16 --------------------------------------------------------------------------- LATLON : Converts the ASCII .XYC file from 'digit' to lat/lon file. Creates a user readable .RAW file. You must give the projection of the paper map that was digitized. Lists all XYC files in a menu to chose from. Command Line: latlon Lists all XYC files in a menu to chose from. latlon name Processes file 'name.xyc'. The following projections are available: Mercator -- m Transverse Mercator -- u Oblique Mercator -- o Modified Plate Carree -- p Albers Equal-Area Conic -- a Lambert Conformal Conic -- l Bonne -- b Orthographic -- t Stereographic -- s Gnomonic -- g Vertical Perspective -- V Tilted Perspective -- P Lambert Azimuthal Equal-Area -- L Azimuthal Equidistant -- z Sinusoidal -- S Polyconic -- y --------------------------------------------------------------------------- LBL2TGA : Allows you to make a raster targa file from .LBL, .PAL, and .DAT files. Command Line: lbl2tga filename Where filename is the name of a LBL file. Options: /n -- where n = pixel bits -> 8, 24 or 32 /r m -- where m = number of pixel replications (m x m) /top -- starts image at top /bottom -- starts image at bottom --------------------------------------------------------------------------- LINEFIX : Line editor which runs off an ASCII .MAP file and binary vector files created above. Command Line: linefix Options: /d -- Uses puck as a mouse /a map_name -- Forces a map file /v -- Runs in standard VGA mode (640x480x16 colors) --------------------------------------------------------------------------- MAKE5D : Makes and views 5-D image displays from 24-bit images. Requires a LBL file for the 8-bit color image of the type made by program IMVIS when combining channels. Command Line: make5d where: path is location of data files Example: make5d l:\landsat\ LBL Output File Example: FILE_TYPE = IMAGE IMAGE_LINES = 960 LINE_SAMPLES = 1280 IMAGE_POINTER = 'ls432.dat' PAL_POINTER = 'ls432.pal' PALETTE_POINTER = 'ls432.pal' SAMPLE_RATE = 1 CHANNEL_INPUT: RED = s_ch4.dat Range = 13 32 61 GREEN = s_ch3.dat Range = 13 32 61 BLUE = s_ch2.dat Range = 13 32 61 where: SAMPLE_RATE = 1 for every pixel, 2 for every other pixel etc. CHANNEL_INPUT = files containing original data used to make color image. RANGE = 1, 50 and 99 percentile points or 0, 128 and 255 DN settings. --------------------------------------------------------------------------- MAKEBLB: Converts the flat ASCII .LAB files which contain the color fill information to binary label files. For use in 'mapper'. Command Line: makeblb name1 name2 name3 etc. Where name1 will be the name of the BLB file and all ather files will be processed and added in order. --------------------------------------------------------------------------- MAKELAB: Reverse of MAKEBLB but cuts by lat/lon. Command Line: makelab infile outfile Example: makelab geology va_geol 40 36 -75 -84 This will cut out points in the binary geology color file which are located in Virginia. --------------------------------------------------------------------------- MAKERAW : Creates ASCII .RAW files from the binary .BIN and .HDR files and can be used to extract a small subset from a large area file. Command Line: makeraw [MaxLat MinLat MaxLon MinLon] or makeraw /p [MaxLat MinLat MaxLon MinLon] options: /a num -- selects only attribute num or any other number. /l num -- all lines of num or less points will go into outfile.SRT MaxLat MinLat MaxLon MinLon -- processes only lines which may intersect lat/lon limits given. /p MaxLat MinLat MaxLon MinLon -- processes only points within lat/lon limits. /P MaxLat MinLat MaxLon MinLon -- processes only points withinlat/lon limits and places intermidiate points at limits. PROCESS (1) ALL LINES AND ALL POINTS: makeraw [source name] [dest. name] (2) ONLY ONE ATTRIBUTE: makeraw [source name] [dest. name] /a [attribute number] (3) ONLY LINES IN OR NEAR A LAT/LON BOX: makeraw[source name] [dest. name] (4) ONLY POINTS IN A LAT/LON BOX (RAGGED EDGE): makeraw[source name][dest. name]/p (5) ONLY POINTS IN A LAT/LON BOX AND INTERPOLATE EDGE POINTS (SMOOTH EDGE): makeraw[source name][dest. name]/P --------------------------------------------------------------------------- MAPPER : Displays the vectors. Runs off an ASCII .MAP file. Creates image .XMP files (if running in extended VGA; .VMP if running in VGA etc.), mapper.MRK files, and ASCII .LAB files. Command Line: mapper Options: /e = EGA /v = VGA 640x480x16 colors /s = VGA 320x200x256 colors /y = Extended VGA 640x400x256 colors /x = Extended VGA 640x480x256 colors /l [path][file_name].[file_type] = output '.LAB' file of points /o [path][file_name].[file_type] = output run information file /a [path][file_name] = automatic map load on start /p [program_name] = passes control to program from point (S)earch /r creates a '.MPR' file with ranges of data for all files then stops /h help -- prints this message /grid [sample rate] = outputs 'grid.lab' entry for a grid of points /screen puts vector screen coordinates in mapper.crd save [name.map] creates and saves a map in batch mode label [message_up_to_100_characters] Any path name for data search can by added also, e.g. D:\DATA or \MAPPER\DATA\MAP --------------------------------------------------------------------------- MAPSPLIN : Sets up parameters for processing BIN, HDR and ATR files into an elevation grid then calls SPLNBIN to process the data. Command Line: mapsplin --------------------------------------------------------------------------- RASTMAP : Makes raster map files for printing maps and map keys and for analysis of map data. Reads a PMP (Paper MaP) file describing the map and the lines, symbols and text to be plotted on the map and creates, edits and prepares for printing maps and keys. Input files: PMP, RMP, LBL, HDR, BIN, BLB, GRF Output files: PAL, KMP, XYC, LBL and RMP Command Line options (in normal order of use): /M --> Make a PMP (paper map instruction) file from a MAP file /m --> make RMP (raster map) base file /e --> edit RMP (raster map) base file /a --> measure area of colors on map /f --> make final RMP (raster map) print file over base file /k --> make KMP (map key) /M Makes a PMP (Paper MaP) file from a MAP file. This needs to be edited with a word processor to remove duplicate file names with filter scale suffixes and to turn on vectors (lines) to be plotted. /m Reads the PMP file and makes the RMP (raster map file) onto which all other data are plotted. Also makes an LBL and PAL file all with the same name as the PMP file. The RMP file should be compressed as a back up. PMP file entries required to define map: LINE_COLOR = BACKGROUND_COLOR = CONTACT_COLOR = PROJECTION = . . . . . . where: Projection Letter Id: Mercator -- m Stereographic -- s Transverse Mercator -- u Gnomonic -- g Oblique Mercator -- o Vertical Perspective -- V Modified Plate Cree -- p Tilted Perspective -- P Albers Equal-Area Conic -- a Lambert Azimuthal Equal-Area -- L Lambert Conformal Conic -- l Azimuthal Equidistant -- z Bonne -- b Sinusoidal -- S Orthographic -- t Polyconic -- y ----------------------------------------------------------------- Required Variables marked by '*' Variable Description Var m u o p a l b t s g V P L z S y ------------------------- ------- ------------------------------- central latitude(deg) LAT_0 . * . * * * . . . . . . . . . * central longitude(deg) LON_0 * * . * * * * * * * * * * * * * 1st stand. parallel(deg) LAT_1 . . * . * * * * * * * * * * . . 2nd stand. parallel(deg) LAT_2 . . * . * * . . . . . . . . . . 1st point longitude(deg) LON_1 . . * . . . . . . . . . . . . . 2nd point longitude(deg) LON_2 . . * . . . . . . . . . . . . . scale factor usually 1) K0 . . . . . . . . * . . . . . . . viewing altitude(km) H . . . . . . . . . . * * . . . . viewing azimuth(N=0)(deg) GAMMA . . . . . . . . . . . * . . . . viewing angle(down=0)(deg)OMEGA . . . . . . . . . . . * . . . . LAT_UPPER_LEFT_CORNER = LON_UPPER_LEFT_CORNER = LAT_LOWER_RIGHT_CORNER = LON_LOWER_RIGHT_CORNER = PIXEL_SIZE = m PMP file entries required to plot map: AREA_COLOR [text] PLOT_CONTACT FILL_POLYGONS /e Edits the map and previews final printing also makes and edits BLB files. After editing file compress it with and without contacts for future use. RMP file required for this step. PMP file entries used to plot map: PLOT_LINE_PATTERN [text] ROW_COL_HOTROW = PLOT_LINE [text] PLOT_GRAPH PLOT_BLB_TEXT --------------------------------------------------------------------------- REMARK : Adds the appropriate number of underscores ( _ ) to a name within the mapper.MRK file. Used in the .GRF file. File mapper.mrk: Madison_ 45.579738 -89.842150 Madison_ _Linton 45.615731 -89.816872 _Linton becomes file remark.mrk: Madison_________ 45.579738 -89.842150 Madison_ ________Linton 45.615731 -89.816872 _Linton so that the city name will be to one side of the city symbol. --------------------------------------------------------------------------- REORDER : Converts the ASCII .RAW file to machine-readable binary .HDR, .ATR, and .BIN files. Command Line: reorder in_name style where style: p -- order of line segments remains unchanged r -- reorders line segments from east to west R -- reorders line segments from east to west and removes duplicates in_name -- a single name or with wild cards /b -- brief (quiet mode, runs faster) Examples: reorder strm01 r reorder strm* p /b reorder ??strm* R --------------------------------------------------------------------------- SHOW : Shows film loops. Program 'show' displays a sequence of quarter screen images all of which use the same palette (or color look up table). Before you can use this program you must run program 'showprep' which reads a series of '.dat' files. Command Line: show or show [shw_name] --------------------------------------------------------------------------- SHOWPREP : Makes film loops from 640x480 images. Command Line: showprep name* or showprep name??? or showprep /script name.spt where .SPT format is: file01.dat message_01 file02.dat message_02 etc. and message can be up to 39 characters long The name must contain wild cards (option 1&2) to identify a series of '.dat' files. The files will be processed in alphabetical order (except option 3) --------------------------------------------------------------------------- SPLNBIN : Processes BIN, HDR and ATR files into a set of LBS and a D64 files by splineing, then calls TRIGRID to make a WVF file. SPLNBIN calls TRIGRID automatically. Command Line: splnbin [in][out][lat][lon][dlat][dlon][nlat][nlon][flex] where: in -- input file name (without extention) out -- output file name (without extention) lat -- upper left corner latitude lon -- upper left corner longitude dlat -- latitude spacing of lines in degrees dlon -- longitude spacing of lines in degrees nlat -- number of latitude lines nlon -- number of longitude lines flex -- spline flexibility (0.0 for no curve to 1.0 for max curve) Options: To Use Default Extrapolation -------- /e ON NO_USE OFF USE Isopleth Violations -- /v OFF ON Spline Border -------- /b OFF ON or use program MAPSLIN to set up data and call this program automatically. --------------------------------------------------------------------------- THINPTS : Converts PTS files (tables of Z with lat/lon) to V (vertex) files Command Line to Count Points Only: thinpts [in_file] Command Line Process Points: thinpts [in_file] [thin_number] where: in_file -- input file name with file type thin_number -- floating point number of ratio of points to save (must be 1.0 or greater) max_pts -- optional resetting of maximum number of points (default is %ld) --------------------------------------------------------------------------- THINRAW : Converts RAW files to V (vertex) files. Command Line to Count Points Only: thinraw [raw_name] Command Line Process Points: thinraw [in_file] [out_file] [thin_number] where: in_file -- input '.raw' file name without file type out_file -- name of output file ( type will be made '.v' ) thin_number -- floating point number of ratio of points to save (must be 1.0 or greater) max_pts -- optional resetting of maximum number of points (default is 14,000) --------------------------------------------------------------------------- TRIGRID : Reads an LBS (surface label) file and uses the information to process the elevation grid into a WVF (Wave Front X,Y,Z) file. Example of LBS: FILE_TYPE = ELEVATION_ARRAY UPPER_LEFT_LAT = 36.25000 UPPER_LEFT_LON = -122.75000 DELTA_LAT = 0.002000 DELTA_LON = 0.002000 NUMBER_OF_LAT = 120 NUMBER_OF_LON = 240 DATA_TYPE = float DATA_SIZE = 4 bytes DATA_FILE_POINTER = 'm102.D64' MISSING_DATA_VALUE = -99.0 (if needed) LOWER_RIGHT_LAT = 36.01200 (optional) LOWER_RIGHT_LON = -122.51200 (optional) IMAGE_LINES = 120 (optional) LINE_SAMPLES = 240 (optional) MAXIMUM_Z = -2021.94263 (optional) MINIMUM_Z = -3482.91040 (optional) SPLINE_FLEXIBILITY = 0.20000 (other remarks as needed) where data type and size must be one of following: unsigned char 1 byte 0 to 255 char 1 byte -128 to 127 unsigned short 2 bytes 0 to 65,536 short 2 bytes -32,768 to 32,767 unsigned long 4 bytes 0 to 4,294,967,296 long 4 bytes -2,147,483,648 to 2,147,483,647 float 4 bytes -1E-38 to 1E38 double 8 bytes -1E307 to 1E307 float allows 7 significant figures while double allows 15. --------------------------------------------------------------------------- TRIMAKE : Performs Delaunay triangulation of a set of points in a V file. Coincident points ate rejected. Makes W and WVF files for Viewing 3-D objects. Command Line: trimake input output where: input -- input file vertices (V) output -- output file triangles (W) and wave front (WVF) --------------------------------------------------------------------------- VIEW3D : Makes Red/Blue 3-D images viewable. It reads a 3D file made by program WAVE and creates a Red/Blue 3-D image set viewable by imvis or for processing in SHOWPREP for program SHOW. Command Line for Batch: view3d infile Command Line for Menu: view3d --------------------------------------------------------------------------- VIEW5D : Views images made by MAKE5D. --------------------------------------------------------------------------- WAVE : Views 3-D images and makes a variety of image files. Command Line Options: wave /pc <------------------------ Pseudo Color for option 'r' wave /ct <------------------------ Contour + Render option 'r' wave /cto <------------------------ Contour Only option 'r' wave /auto [filename.ctl] <------- Scripts rendered images wave /auto [filename.ctl] /pc <---- Scripts pseudo color images wave /auto3d [filename.ctl] <---- Scripts red/blue 3d images wave /auto3dc [filename.ctl] <---- Scripts half tone stereo images wave /auto3d [filename.ctl] /pc <-- Scripts pseudo color stereo images Reads a wave front formatted file and makes a binary file all numbers are floats. verticies normal x1,y1,z1,x2,y2,z2,x3,y3,z3, i1,j1,k1,i2,j2,k2 If file 'wave.lit' is present, the location and brightness of two lights can be set as well as the background color of the image. 1.0 1.0 1.0 sun location 1.00 sun brite -1.0 -1.0 -1.0 moon location 0.00 moon brite 0.05 backlite 64 32 16 background color CONTROL FILE: input = [filename] the type must be '.bwv' but is not needed rot_x -90 pushes top of image back 90 degrees rot_y 90 pushes right side of image back 90 degrees rot_z 25 rotates image 25 degrees counter clockwise move_x 0.25 moves image to right 0.25 inches move_y 0.25 moves image up 0.25 inches move_z 0.25 moves image out of screen right 0.25 inches set_size 50 sets image scale to 50 pixels/inch scale_size 0.95 reduces images scale by 5% set_view 2500 sets viewing point 2500 pixels from screen (2500/50 = 50 inches) scale_view 1.05 moves view point out 5% vertical 2.0 doubles the z axis output = [filename] name of '.3d' file plot makes the 'filename.3d' image file mesh makes a mesh for checking file PSEUDO COLOR FILE: 'mont_y.pc': 0.0 = mid_z 49.644 scale km/in 50.00 last vertical exaggeration 0.500 shadow brightness min max r g b 1.000 1.500 255 128 0 0.500 1.000 255 255 0 0.000 0.500 0 255 0 -1.000 0.000 128 255 255 -2.000 -1.000 128 255 255 -3.000 -2.000 106 191 255 -4.000 -3.000 85 128 255 -5.000 -4.000 64 64 255 -6.000 -5.000 128 0 255 CONTOUR COLOR FILE: 'test.ctr' -2.756676392 = mid_z (km) 3.016983 scale km/in 10.00 last vertical exaggeration height(km) r g b 0.000 255 255 255 0.250 0 0 0 0.500 0 0 0 0.750 0 0 0 1.000 255 255 255 1.250 0 0 0 1.500 0 0 0 1.750 0 0 0 2.000 255 255 255 2.250 0 0 0 2.500 0 0 0 --------------------------------------------------------------------------- WAVEPREP : Prepares WVF files for binary input into WAVE for display. --------------------------------------------------------------------------- XMP2LBL : Creates an ASCII label file from the .XMP files created by 'mapper'. .LBL files used with 'imvis'. --------------------------------------------------------------------------- XY : Converts map or image coordinate files (XYC) to earth coordinate files (RAW). ---------------------------------------------------------------------------