POLMERGE - IFF POLYGON MERGING UTILITY

--------------------------------------------------------------------------------
MODULE    POLMERGE

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

FUNCTION

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

FORMAT


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

PROMPTS

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

PARAMETERS

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

COMMAND QUALIFIERS

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

RESTRICTIONS

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

DESCRIPTION

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

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

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

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

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

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

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

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

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

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

EXAMPLES

$ POLMERGE TEST50/LOG EXAMPLE1<CR>
%LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[POLYGONS.POLMERGE]TEST50.IFJ;1 opened for read
%LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[POLYGONS.POLMERGE]EXAMPLE1.IFJ;3 opened for write
 
 
%POLY-I-POLVAL, Maximum number of polygons set to a default of 40000
%POLY-I-DEFSID, Average number of sides per polygons set to a default of 5
+----------------------------------------------------------------+
|                                                                |
|                     Building IFF address tables                |
|                                                                |
+----------------------------------------------------------------+
 
Number of IFF segment feature addresses tabulated ... 465
Segment coordinate range is:
X-min ...............................................     0.000
X-max ...............................................    50.000
Y-min ...............................................     0.000
Y-max ...............................................    50.000
 
 
+----------------------------------------------------------------+
|                                                                |
|                         Forming polygons                       |
|                                                                |
+----------------------------------------------------------------+
 
Number of polygons formed (including isolations) ... 229
Number of segments used to form polygons ........... 465
Minimum number of segments used to form a polygon .. 1
Maximum number of segments used to form a polygon .. 88
Direction of polygon formation ..................... ANTICLOCKWISE
 
 
+----------------------------------------------------------------+
|                                                                |
|          Setting up sectored spatial index for polygons        |
|                                                                |
+----------------------------------------------------------------+
 
Number of boxes in X direction....................... 3
Number of boxes in Y direction....................... 3
Mean number of boxes per polygon ....................     0.039
Mean number of polygons per box .....................    25.444
 
 
+----------------------------------------------------------------+
|                                                                |
|                 Identifying isolated polygons                  |
|                                                                |
+----------------------------------------------------------------+
 
Number of polygons examined ......................... 229
Number of isolated polygons ......................... 18
 
 
+----------------------------------------------------------------+
|                                                                |
|                    Identifying nested polygons                 |
|                                                                |
+----------------------------------------------------------------+
 
Number of polygons examined ......................... 229
Number of polygons containing nested polygons ....... 4
Number of polygons nested inside others ............. 75
 
 
+----------------------------------------------------------------+
|                                                                |
|                   Checking Polygon Consistency                 |
|                                                                |
+----------------------------------------------------------------+
 
 
 
+----------------------------------------------------------------+
|                                                                |
|                      Calculating Polygon Areas                 |
|                                                                |
+----------------------------------------------------------------+
 
Maximum Polygon area ...   751.000
Minimum Polygon area ...     1.000
 
 
+----------------------------------------------------------------+
|                                                                |
|                      Merging Polygons                          |
|                                                                |
+----------------------------------------------------------------+
 
Area Tolerance .................................... 25.000
Number of polygons considered for merging ......... 123
Number of polygons merged ......................... 123
 
 
+----------------------------------------------------------------+
|                                                                |
|                      Eliminating Polygons                      |
|                                                                |
+----------------------------------------------------------------+
 
Area Tolerance ........................................ 25.000
Number of polygons considered for elimination ......... 52
Number of polygons eliminated ......................... 52
 
 
+----------------------------------------------------------------+
|                                                                |
|                      Writing output IFJ file                   |
|                                                                |
+----------------------------------------------------------------+
 
Number of segments written to output file ......... 24
 
 
 ELAPSED:    0 00:04:12.96  CPU: 0:03:40.90  BUFIO: 17  DIRIO: 204  FAULTS: 843 
 

 
 $ POLMERGE TEST50/MER=(BY_LOOKUP)/ELIM/AREA=(MER:5,ELIM:5) - 
 EXAMPLE2/LOG/RATIO=(MER:7,ELIM:7,AREA:25)/LOOKUP=POLMERGE.DAT<CR>
%LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[POLYGONS.POLMERGE]TEST50.IFJ;1 opened for read
%LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[POLYGONS.POLMERGE]EXAMPLE2.IFJ;5 opened for write
%PMERGE-I-LKPOPNREAD, Lookup file LSL$LOOKUP:POLMERGE.DAT opened for reading 
 

(For the sake of clarity all the log information has not been included here or in the following examples because the polygon formation statistics are the same as in the first example.) [ POLYGON FORMATION STATISTICS HERE ] +----------------------------------------------------------------+ | | | Merging Polygons | | | +----------------------------------------------------------------+ Area Tolerance .................................... 5.000 Ratio Tolerance ................................... 7.000 Ratio Area Tolerance .............................. 25.000 Lookup File ....LSL$LOOKUP:POLMERGE.DAT Number of polygons considered for merging ......... 112 Number of polygons merged ......................... 112 +----------------------------------------------------------------+ | | | Eliminating Polygons | | | +----------------------------------------------------------------+ Area Tolerance ........................................ 5.000 Ratio Tolerance ....................................... 7.000 Ratio Area Tolerance .................................. 25.000 Lookup File.....LSL$LOOKUP:POLMERGE.DAT Number of polygons considered for elimination ......... 38 Number of polygons eliminated ......................... 38 +----------------------------------------------------------------+ | | | Writing output IFJ file | | | +----------------------------------------------------------------+ Number of segments written to output file ......... 72 ELAPSED: 0 00:51:12.80 CPU: 0:03:27.71 BUFIO: 27 DIRIO: 424 FAULTS: 830

$ POLMERGE TEST50/LOG/NOMERGE/ELIM=(BY_LOOKUP)/LOOKUP=POLMERGE.DAT 
EXAMPLE3<CR>
%LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[POLYGONS.POLMERGE]TEST50.IFJ;1 opened for read
%LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[POLYGONS.POLMERGE]EXAMPLE3.IFJ;5 opened for write
%PMERGE-I-LKPOPNREAD, Lookup file LSL$LOOKUP:POLMERGE.DAT opened for reading 
 
               [ POLYGON FORMATION STATISTICS HERE ]
 
+----------------------------------------------------------------+
|                                                                |
|                      Eliminating Polygons                      |
|                                                                |
+----------------------------------------------------------------+
 
Area Tolerance ........................................   25.000
Lookup File .....LSL$LOOKUP:POLMERGE.DAT
Number of polygons considered for elimination ......... 18
Number of polygons eliminated ......................... 10
 
 
+----------------------------------------------------------------+
|                                                                |
|                      Writing output IFJ file                   |
|                                                                |
+----------------------------------------------------------------+
 
Number of segments written to output file ......... 447
 
 ELAPSED:    0 00:07:27.07  CPU: 0:04:10.41  BUFIO: 23  DIRIO: 2344  FAULTS: 794 

$ POLMERGE TEST20.DUFF/LOG EXAMPLE4<CR> %POLMERGE-E-ACINCON, polygon labels in AC texts inconsistent in feature with FSN 13 (13) \Current segment: 3\ \Previous segment: 2\ Polygon labels in AC texts inconsistent in feature with FSN 13 - polygon abandoned %POLMERGE-E-ACINCON, polygon labels in AC texts inconsistent in feature with FSN 15 (15) \Current segment: 1\ \Previous segment: 4\ Polygon labels in AC texts inconsistent in feature with FSN 15 - polygon abandoned ELAPSED: 0 00:00:21.61 CPU: 0:00:19.43 BUFIO: 8 DIRIO: 21 FAULTS: 920

$ POLMERGE TEST50/AREA=(MER:10,NOELIM)/ELIM=(BY_LOOKUP) - /MER=(BY_LARGE)/LOOKUP=POLMERGE.DAT EXAMPLE5/LOG<CR> %LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[POLYGONS.POLMERGE]EXAMPLE5.IFJ;1 opened for read %LSLLIB-I-IFFOPENED, LSL$SOURCE_ROOT:[POLYGONS.POLMERGE]EXAMPLE5.IFJ;11 opened for write [ POLYGON FORMATION STATISTICS HERE] +----------------------------------------------------------------+ | | | Merging Polygons | | | +----------------------------------------------------------------+ Area Tolerance ................................... 10.000 Lookup File ....LSL$LOOKUP:POLMERGE.DAT Number of polygons considered for merging ......... 121 Number of polygons merged ......................... 121 +----------------------------------------------------------------+ | | | Eliminating Polygons | | | +----------------------------------------------------------------+ Lookup File ....LSL$LOOKUP:POLMERGE.DAT Number of polygons considered for elimination ......... 48 Number of polygons eliminated ......................... 40 +----------------------------------------------------------------+ | | | Writing output IFJ file | | | +----------------------------------------------------------------+ Number of segments written to output file ......... 50 ELAPSED: 0 00:04:15.21 CPU: 0:03:34.31 BUFIO: 22 DIRIO: 347 FAULTS: 1055

See polmergemsg.html generated from POLMERGEMSG.RNO.