Imported Debian patch 1.2.1-1
[debian/splat] / docs / english / man / splat.1
1 SPLAT!(1)                 KD2BD Software                SPLAT!(1)
2
3
4
5 N\bNA\bAM\bME\bE
6        splat - An RF S\bSignal P\bPropagation, L\bLoss, A\bAnd T\bTerrain analy-
7        sis tool
8
9 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
10        splat [-t   _\bt_\br_\ba_\bn_\bs_\bm_\bi_\bt_\bt_\be_\br_\b__\bs_\bi_\bt_\be_\b._\bq_\bt_\bh]  [-r  _\br_\be_\bc_\be_\bi_\bv_\be_\br_\b__\bs_\bi_\bt_\be_\b._\bq_\bt_\bh]
11        [-c   _\br_\bx   _\ba_\bn_\bt_\be_\bn_\bn_\ba   _\bh_\be_\bi_\bg_\bh_\bt   _\bf_\bo_\br  _\bL_\bO_\bS  _\bc_\bo_\bv_\be_\br_\ba_\bg_\be  _\ba_\bn_\ba_\bl_\by_\bs_\bi_\bs
12        _\b(_\bf_\be_\be_\bt_\b/_\bm_\be_\bt_\be_\br_\bs_\b) _\b(_\bf_\bl_\bo_\ba_\bt_\b)] [-L _\br_\bx _\ba_\bn_\bt_\be_\bn_\bn_\ba _\bh_\be_\bi_\bg_\bh_\bt _\bf_\bo_\br  _\bL_\bo_\bn_\bg_\bl_\be_\by_\b-
13        _\bR_\bi_\bc_\be  _\bc_\bo_\bv_\be_\br_\ba_\bg_\be  _\ba_\bn_\ba_\bl_\by_\bs_\bi_\bs  _\b(_\bf_\be_\be_\bt_\b/_\bm_\be_\bt_\be_\br_\bs_\b)  _\b(_\bf_\bl_\bo_\ba_\bt_\b)] [-p _\bt_\be_\br_\b-
14        _\br_\ba_\bi_\bn_\b__\bp_\br_\bo_\bf_\bi_\bl_\be_\b._\be_\bx_\bt]    [-e    _\be_\bl_\be_\bv_\ba_\bt_\bi_\bo_\bn_\b__\bp_\br_\bo_\bf_\bi_\bl_\be_\b._\be_\bx_\bt]     [-h
15        _\bh_\be_\bi_\bg_\bh_\bt_\b__\bp_\br_\bo_\bf_\bi_\bl_\be_\b._\be_\bx_\bt] [-H _\bn_\bo_\br_\bm_\ba_\bl_\bi_\bz_\be_\bd_\b__\bh_\be_\bi_\bg_\bh_\bt_\b__\bp_\br_\bo_\bf_\bi_\bl_\be_\b._\be_\bx_\bt] [-l
16        _\bL_\bo_\bn_\bg_\bl_\be_\by_\b-_\bR_\bi_\bc_\be_\b__\bp_\br_\bo_\bf_\bi_\bl_\be_\b._\be_\bx_\bt]    [-o     _\bt_\bo_\bp_\bo_\bg_\br_\ba_\bp_\bh_\bi_\bc_\b__\bm_\ba_\bp_\b__\bf_\bi_\bl_\be_\b-
17        _\bn_\ba_\bm_\be_\b._\bp_\bp_\bm]   [-b   _\bc_\ba_\br_\bt_\bo_\bg_\br_\ba_\bp_\bh_\bi_\bc_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by_\b__\bf_\bi_\bl_\be_\bn_\ba_\bm_\be_\b._\bd_\ba_\bt]  [-s
18        _\bs_\bi_\bt_\be_\b/_\bc_\bi_\bt_\by_\b__\bd_\ba_\bt_\ba_\bb_\ba_\bs_\be_\b._\bd_\ba_\bt] [-d _\bs_\bd_\bf_\b__\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by_\b__\bp_\ba_\bt_\bh] [-m  _\be_\ba_\br_\bt_\bh
19        _\br_\ba_\bd_\bi_\bu_\bs _\bm_\bu_\bl_\bt_\bi_\bp_\bl_\bi_\be_\br _\b(_\bf_\bl_\bo_\ba_\bt_\b)] [-f _\bf_\br_\be_\bq_\bu_\be_\bn_\bc_\by _\b(_\bM_\bH_\bz_\b) _\bf_\bo_\br _\bF_\br_\be_\bs_\bn_\be_\bl
20        _\bz_\bo_\bn_\be _\bc_\ba_\bl_\bc_\bu_\bl_\ba_\bt_\bi_\bo_\bn_\bs _\b(_\bf_\bl_\bo_\ba_\bt_\b)]  [-R  _\bm_\ba_\bx_\bi_\bm_\bu_\bm  _\bc_\bo_\bv_\be_\br_\ba_\bg_\be  _\br_\ba_\bd_\bi_\bu_\bs
21        _\b(_\bm_\bi_\bl_\be_\bs_\b/_\bk_\bi_\bl_\bo_\bm_\be_\bt_\be_\br_\bs_\b)  _\b(_\bf_\bl_\bo_\ba_\bt_\b)] [-dB _\bm_\ba_\bx_\bi_\bm_\bu_\bm _\ba_\bt_\bt_\be_\bn_\bu_\ba_\bt_\bi_\bo_\bn _\bc_\bo_\bn_\b-
22        _\bt_\bo_\bu_\br _\bt_\bo _\bd_\bi_\bs_\bp_\bl_\ba_\by _\bo_\bn _\bp_\ba_\bt_\bh _\bl_\bo_\bs_\bs _\bm_\ba_\bp_\bs _\b(_\b8_\b0_\b-_\b2_\b3_\b0 _\bd_\bB_\b)] [-fz  _\bF_\br_\be_\bs_\b-
23        _\bn_\be_\bl  _\bz_\bo_\bn_\be  _\bc_\bl_\be_\ba_\br_\ba_\bn_\bc_\be  _\bp_\be_\br_\bc_\be_\bn_\bt_\ba_\bg_\be  _\b(_\bd_\be_\bf_\ba_\bu_\bl_\bt  _\b=  _\b6_\b0_\b)]  [-plo
24        _\bp_\ba_\bt_\bh_\b__\bl_\bo_\bs_\bs_\b__\bo_\bu_\bt_\bp_\bu_\bt_\b__\bf_\bi_\bl_\be_\b._\bt_\bx_\bt] [-pli _\bp_\ba_\bt_\bh_\b__\bl_\bo_\bs_\bs_\b__\bi_\bn_\bp_\bu_\bt_\b__\bf_\bi_\bl_\be_\b._\bt_\bx_\bt]
25        [-udt   _\bu_\bs_\be_\br_\b__\bd_\be_\bf_\bi_\bn_\be_\bd_\b__\bt_\be_\br_\br_\ba_\bi_\bn_\b__\bf_\bi_\bl_\be_\b._\bd_\ba_\bt]   [-n]  [-N]  [-nf]
26        [-ngs] [-geo] [-kml] [-metric]
27
28 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
29        S\bSP\bPL\bLA\bAT\bT!\b! is a powerful terrestrial RF propagation  and  ter-
30        rain  analysis tool for the spectrum between 20 MHz and 20
31        GHz.  S\bSP\bPL\bLA\bAT\bT!\b! is free software, and is designed for  opera-
32        tion on Unix and Linux-based workstations.  Redistribution
33        and/or modification is permitted under the  terms  of  the
34        GNU General Public License, Version 2, as published by the
35        Free Software Foundation.  Adoption of S\bSP\bPL\bLA\bAT\bT!\b!  source code
36        in  proprietary  or closed-source applications is a viola-
37        tion of this license and is s\bst\btr\bri\bic\bct\btl\bly\by forbidden.
38
39        S\bSP\bPL\bLA\bAT\bT!\b! is distributed in the hope that it will be  useful,
40        but  WITHOUT  ANY  WARRANTY, without even the implied war-
41        ranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PUR-
42        POSE.   See  the  GNU  General  Public  License  for  more
43        details.
44
45 I\bIN\bNT\bTR\bRO\bOD\bDU\bUC\bCT\bTI\bIO\bON\bN
46        Applications of S\bSP\bPL\bLA\bAT\bT!\b! include the visualization,  design,
47        and  link  budget  analysis of wireless Wide Area Networks
48        (WANs), commercial and amateur radio communication systems
49        above  20 MHz, microwave links, frequency coordination and
50        interference studies, and the  prediction  of  analog  and
51        digital  terrestrial radio and television contour regions.
52
53        S\bSP\bPL\bLA\bAT\bT!\b! provides RF site engineering  data  such  as  great
54        circle  distances and bearings between sites, antenna ele-
55        vation  angles  (uptilt),  depression  angles  (downtilt),
56        antenna  height above mean sea level, antenna height above
57        average terrain, bearings, distances,  and  elevations  to
58        known  obstructions,  Longley-Rice  path  attenuation, and
59        received  signal  strength.   In  addition,  the   minimum
60        antenna  height  requirements needed to clear terrain, the
61        first Fresnel zone, and any user-definable  percentage  of
62        the first Fresnel zone are also provided.
63
64        S\bSP\bPL\bLA\bAT\bT!\b! produces reports, graphs, and high resolution topo-
65        graphic maps that depict line-of-sight paths, and regional
66        path  loss  and  signal  strength  contours  through which
67        expected coverage areas of transmitters and repeater  sys-
68        tems  can  be obtained.  When performing line-of-sight and
69        Longley-Rice analyses in situations where multiple  trans-
70        mitter  or  repeater sites are employed, S\bSP\bPL\bLA\bAT\bT!\b! determines
71        individual and mutual areas of coverage within the network
72        specified.
73
74        Simply typing splat on the command line will return a sum-
75        mary of S\bSP\bPL\bLA\bAT\bT!\b!'s command line options:
76
77
78                     --==[  SPLAT!  v1.2.1  Available   Options...
79        ]==--
80
81             -t  txsite(s).qth  (max  of 4 with -c, max of 30 with
82        -L)
83             -r rxsite.qth
84             -c plot coverage of TX(s) with an  RX  antenna  at  X
85        feet/meters AGL
86             -L  plot  path  loss  map  of  TX based on an RX at X
87        feet/meters AGL
88             -s filename(s) of city/site file(s) to import (5 max)
89             -b  filename(s)  of  cartographic boundary file(s) to
90        import (5 max)
91             -p filename of terrain profile graph to plot
92             -e filename of terrain elevation graph to plot
93             -h filename of terrain height graph to plot
94             -H filename of normalized  terrain  height  graph  to
95        plot
96             -l filename of Longley-Rice graph to plot
97             -o filename of topographic map to generate (.ppm)
98             -u filename of user-defined terrain file to import
99             -d   sdf  file  directory  path  (overrides  path  in
100        ~/.splat_path file)
101             -m earth radius multiplier
102             -n do not plot LOS paths in .ppm maps
103             -N do not produce  unnecessary  site  or  obstruction
104        reports
105             -f frequency for Fresnel zone calculation (MHz)
106             -R  modify  default range for -c or -L (miles/kilome-
107        ters)
108            -db maximum loss contour to display on path loss  maps
109        (80-230 dB)
110            -nf do not plot Fresnel zones in height plots
111            -fz Fresnel zone clearance percentage (default = 60)
112           -ngs  display  greyscale  topography  as  white in .ppm
113        files
114           -erp override ERP in .lrp file (Watts)
115           -pli filename of path-loss input file
116           -plo filename of path-loss output file
117           -udt filename of user defined terrain input file
118           -kml generate Google Earth (.kml) compatible output
119           -geo generate an Xastir .geo  georeference  file  (with
120        .ppm  output)  -metric  employ metric rather than imperial
121        units for all user I/O
122
123
124 I\bIN\bNP\bPU\bUT\bT F\bFI\bIL\bLE\bES\bS
125        S\bSP\bPL\bLA\bAT\bT!\b! is a  command-line  driven  application  and  reads
126        input data through a number of data files.  Some files are
127        mandatory for successful execution of the  program,  while
128        others are optional.  Mandatory files include 3-arc second
129        topography models in the form of  SPLAT  Data  Files  (SDF
130        files),  site location files (QTH files), and Longley-Rice
131        model parameter files (LRP files).  Optional files include
132        city  location  files,  cartographic boundary files, user-
133        defined terrain  files,  path-loss  input  files,  antenna
134        radiation pattern files, and color definition files.
135
136 S\bSP\bPL\bLA\bAT\bT D\bDA\bAT\bTA\bA F\bFI\bIL\bLE\bES\bS
137        S\bSP\bPL\bLA\bAT\bT!\b!  imports topographic data in the form of SPLAT Data
138        Files (SDFs).  These files may be generated from a  number
139        of  information sources.  In the United States, SPLAT Data
140        Files can be generated  through  U.S.   Geological  Survey
141        Digital Elevation Models (DEMs) using the u\bus\bsg\bgs\bs2\b2s\bsd\bdf\bf utility
142        included with S\bSP\bPL\bLA\bAT\bT!\b!.  USGS Digital Elevation Models  com-
143        patible   with   this  utility  may  be  downloaded  from:
144        _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\be_\bd_\bc_\bf_\bt_\bp_\b._\bc_\br_\b._\bu_\bs_\bg_\bs_\b._\bg_\bo_\bv_\b/_\bp_\bu_\bb_\b/_\bd_\ba_\bt_\ba_\b/_\bD_\bE_\bM_\b/_\b2_\b5_\b0_\b/.
145
146        Significantly  better  resolution  and  accuracy  can   be
147        obtained  through the use of SRTM-3 Version 2 digital ele-
148        vation models.  These models are the product of the STS-99
149        Space  Shuttle Radar Topography Mission, and are available
150        for most populated regions of the Earth.  SPLAT Data Files
151        may  be  generated  from  SRTM  data  using  the  included
152        s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf utility.  SRTM-3 Version 2 data may  be  obtained
153        through            anonymous           FTP           from:
154        _\bf_\bt_\bp_\b:_\b/_\b/_\be_\b0_\bs_\br_\bp_\b0_\b1_\bu_\b._\be_\bc_\bs_\b._\bn_\ba_\bs_\ba_\b._\bg_\bo_\bv_\b:_\b2_\b1_\b/_\bs_\br_\bt_\bm_\b/_\bv_\be_\br_\bs_\bi_\bo_\bn_\b2_\b/
155
156        The s\bst\btr\brm\bm2\b2s\bsd\bdf\bf utility may also be  used  to  convert  3-arc
157        second SRTM data in Band Interleaved by Line (.BIL) format
158        for use with S\bSP\bPL\bLA\bAT\bT!\b!.  This data is available via  the  web
159        at: _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bs_\be_\ba_\bm_\bl_\be_\bs_\bs_\b._\bu_\bs_\bg_\bs_\b._\bg_\bo_\bv_\b/_\bw_\be_\bb_\bs_\bi_\bt_\be_\b/_\bs_\be_\ba_\bm_\bl_\be_\bs_\bs_\b/
160
161        Band Interleaved by Line data must be downloaded in a very
162        specific manner to be compatible with s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf and S\bSP\bPL\bLA\bAT\bT!\b!.
163        Please  consult  s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf's documentation for instructions
164        on downloading .BIL topographic data  through  the  USGS's
165        Seamless Web Site.
166
167        Despite  the  higher accuracy that SRTM data has to offer,
168        some voids  in  the  data  sets  exist.   When  voids  are
169        detected,  the  s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf utility replaces them with corre-
170        sponding data found in existing SDF files (that were  pre-
171        sumably   created  from  earlier  USGS  data  through  the
172        u\bus\bsg\bgs\bs2\b2s\bsd\bdf\bf utility).  If USGS-derived SDF data is not avail-
173        able,  voids are handled through adjacent pixel averaging,
174        or direct replacement.
175
176        SPLAT Data Files contain integer value topographic  eleva-
177        tions  (in  meters)  referenced  to  mean  sea  level  for
178        1-degree by 1-degree regions of the earth with  a  resolu-
179        tion  of  3-arc  seconds.  SDF files can be read in either
180        standard format (_\b._\bs_\bd_\bf) as generated by  the  u\bus\bsg\bgs\bs2\b2s\bsd\bdf\bf  and
181        s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf   utilities,   or   in  bzip2  compressed  format
182        (_\b._\bs_\bd_\bf_\b._\bb_\bz_\b2).  Since uncompressed files can be read slightly
183        faster  than  files  that  have  been  compressed,  S\bSP\bPL\bLA\bAT\bT!\b!
184        searches for needed SDF data in uncompressed format first.
185        If  uncompressed  data  cannot  be  located,  S\bSP\bPL\bLA\bAT\bT!\b!  then
186        searches for data in bzip2 compressed format.  If no  com-
187        pressed  SDF  files can be found for the region requested,
188        S\bSP\bPL\bLA\bAT\bT!\b! assumes the region is over water, and  will  assign
189        an elevation of sea-level to these areas.
190
191        This  feature  of S\bSP\bPL\bLA\bAT\bT!\b! makes it possible to perform path
192        analysis not only over  land,  but  also  between  coastal
193        areas  not  represented  by  Digital Elevation Model data.
194        However, this behavior of S\bSP\bPL\bLA\bAT\bT!\b!  underscores  the  impor-
195        tance  of having all the SDF files required for the region
196        being analyzed if meaningful results are to be expected.
197
198 S\bSI\bIT\bTE\bE L\bLO\bOC\bCA\bAT\bTI\bIO\bON\bN (\b(Q\bQT\bTH\bH)\b) F\bFI\bIL\bLE\bES\bS
199        S\bSP\bPL\bLA\bAT\bT!\b! imports site location  information  of  transmitter
200        and  receiver  sites  analyzed  by  the program from ASCII
201        files having a _\b._\bq_\bt_\bh  extension.   QTH  files  contain  the
202        site's name, the site's latitude (positive if North of the
203        equator, negative if  South),  the  site's  longitude  (in
204        degrees  West, 0 to 360 degrees, or degrees East 0 to -360
205        degrees), and the site's antenna height above ground level
206        (AGL),  each  separated  by  a single line-feed character.
207        The antenna height is assumed  to  be  specified  in  feet
208        unless  followed  by  the  letter  _\bm or the word _\bm_\be_\bt_\be_\br_\bs in
209        either upper or lower case.  Latitude and longitude infor-
210        mation may be expressed in either decimal format (74.6864)
211        or degree, minute, second (DMS) format (74 41 11.0).
212
213        For example, a site location  file  describing  television
214        station  WNJT-DT,  Trenton, NJ (_\bw_\bn_\bj_\bt_\b-_\bd_\bt_\b._\bq_\bt_\bh) might read as
215        follows:
216
217                WNJT-DT
218                40.2828
219                74.6864
220                990.00
221
222        Each transmitter and receiver site analyzed by S\bSP\bPL\bLA\bAT\bT!\b! must
223        be represented by its own site location (QTH) file.
224
225 L\bLO\bON\bNG\bGL\bLE\bEY\bY-\b-R\bRI\bIC\bCE\bE P\bPA\bAR\bRA\bAM\bME\bET\bTE\bER\bR (\b(L\bLR\bRP\bP)\b) F\bFI\bIL\bLE\bES\bS
226        Longley-Rice  parameter data files are required for S\bSP\bPL\bLA\bAT\bT!\b!
227        to determine RF path loss in either point-to-point or area
228        prediction  mode.   Longley-Rice  model  parameter data is
229        read from files having the same base name as the transmit-
230        ter site QTH file, but with a format (_\bw_\bn_\bj_\bt_\b-_\bd_\bt_\b._\bl_\br_\bp):
231
232                15.000  ; Earth Dielectric Constant (Relative per-
233        mittivity)
234                0.005   ; Earth Conductivity (Siemens per meter)
235                301.000 ; Atmospheric Bending Constant (N-units)
236                647.000 ; Frequency in MHz (20 MHz to 20 GHz)
237                5       ; Radio Climate (5 =  Continental  Temper-
238        ate)
239                0       ; Polarization (0 = Horizontal, 1 = Verti-
240        cal)
241                0.50    ; Fraction of  situations  (50%  of  loca-
242        tions)
243                0.90    ; Fraction of time (90% of the time)
244                46000.0 ; ERP in Watts (optional)
245
246        If  an LRP file corresponding to the tx_site QTH file can-
247        not be found, S\bSP\bPL\bLA\bAT\bT!\b! scans the current  working  directory
248        for  the  file "splat.lrp".  If this file cannot be found,
249        then default parameters will be assigned by S\bSP\bPL\bLA\bAT\bT!\b!  and  a
250        corresponding  "splat.lrp"  file  containing these default
251        parameters will be written to the current  working  direc-
252        tory.   The  generated "splat.lrp" file can then be edited
253        by the user as needed.
254
255        Typical Earth dielectric constants and conductivity values
256        are as follows:
257
258                                   Dielectric Constant  Conductiv-
259        ity
260                Salt water       :        80                5.000
261                Good ground      :        25                0.020
262                Fresh water      :        80                0.010
263                Marshy land      :        12                0.007
264                Farmland, forest :        15                0.005
265                Average ground   :        15                0.005
266                Mountain, sand   :        13                0.002
267                City             :         5                0.001
268                Poor ground      :         4                0.001
269
270        Radio climate codes used by S\bSP\bPL\bLA\bAT\bT!\b! are as follows:
271
272                1: Equatorial (Congo)
273                2: Continental Subtropical (Sudan)
274                3: Maritime Subtropical (West coast of Africa)
275                4: Desert (Sahara)
276                5: Continental Temperate
277                6: Maritime Temperate,  over  land  (UK  and  west
278        coasts of US & EU)
279                7: Maritime Temperate, over sea
280
281        The  Continental Temperate climate is common to large land
282        masses in the temperate zone, such as the  United  States.
283        For  paths shorter than 100 km, there is little difference
284        between Continental and Maritime Temperate climates.
285
286        The seventh and eighth parameters in the _\b._\bl_\br_\bp file  corre-
287        spond to the statistical analysis provided by the Longley-
288        Rice model.  In this example, S\bSP\bPL\bLA\bAT\bT!\b! will return the maxi-
289        mum path loss occurring 50% of the time (fraction of time)
290        in 90% of situations (fraction of  situations).   This  is
291        often denoted as F(50,90) in Longley-Rice studies.  In the
292        United States, an F(50,90) criteria is typically used  for
293        digital   television   (8-level   VSB  modulation),  while
294        F(50,50) is used for analog (VSB-AM+NTSC) broadcasts.
295
296        For  further  information  on   these   parameters,   see:
297        _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bf_\bl_\ba_\bt_\bt_\bo_\bp_\b._\bi_\bt_\bs_\b._\bb_\bl_\bd_\br_\bd_\bo_\bc_\b._\bg_\bo_\bv_\b/_\bi_\bt_\bm_\b._\bh_\bt_\bm_\bl                and
298        _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bs_\bo_\bf_\bt_\bw_\br_\bi_\bg_\bh_\bt_\b._\bc_\bo_\bm_\b/_\bf_\ba_\bq_\b/_\be_\bn_\bg_\bi_\bn_\be_\be_\br_\bi_\bn_\bg_\b/_\bp_\br_\bo_\bp_\b__\bl_\bo_\bn_\bg_\b-
299        _\bl_\be_\by_\b__\br_\bi_\bc_\be_\b._\bh_\bt_\bm_\bl
300
301        The  final  parameter  in the _\b._\bl_\br_\bp file corresponds to the
302        transmitter's effective radiated power, and  is  optional.
303        If  it  is included in the levels and field strength level
304        contours when performing  Longley-Rice  studies.   If  the
305        parameter  is omitted, path loss is computed instead.  The
306        ERP provided in the _\b._\bl_\br_\bp file can be overridden  by  using
307        S\bSP\bPL\bLA\bAT\bT!\b!'s  _\b-_\be_\br_\bp command-line switch.  If the _\b._\bl_\br_\bp file con-
308        tains an ERP parameter and  the  generation  of  path-loss
309        rather  than  signal strength contours is desired, the ERP
310        can be assigned to zero using the _\b-_\be_\br_\bp switch without hav-
311        ing to edit the _\b._\bl_\br_\bp file to accomplish the same result.
312
313 C\bCI\bIT\bTY\bY L\bLO\bOC\bCA\bAT\bTI\bIO\bON\bN F\bFI\bIL\bLE\bES\bS
314        The  names  and locations of cities, tower sites, or other
315        points of interest may be imported and  plotted  on  topo-
316        graphic  maps  generated  by  S\bSP\bPL\bLA\bAT\bT!\b!.   S\bSP\bPL\bLA\bAT\bT!\b! imports the
317        names of cities and locations from ASCII files  containing
318        the  location of interest's name, latitude, and longitude.
319        Each field is separated by a comma.  Each record is  sepa-
320        rated  by  a  single line feed character.  As was the case
321        with the _\b._\bq_\bt_\bh files, latitude  and  longitude  information
322        may be entered in either decimal or degree, minute, second
323        (DMS) format.
324
325        For example (_\bc_\bi_\bt_\bi_\be_\bs_\b._\bd_\ba_\bt):
326
327                Teaneck, 40.891973, 74.014506
328                Tenafly, 40.919212, 73.955892
329                Teterboro, 40.859511, 74.058908
330                Tinton Falls, 40.279966, 74.093924
331                Toms River, 39.977777, 74.183580
332                Totowa, 40.906160, 74.223310
333                Trenton, 40.219922, 74.754665
334
335        A total of five separate city data files may  be  imported
336        at  a  time,  and  there  is no limit to the size of these
337        files.  S\bSP\bPL\bLA\bAT\bT!\b! reads city  data  on  a  "first  come/first
338        served"  basis, and plots only those locations whose anno-
339        tations do not conflict with annotations of locations read
340        earlier  in  the  current  city  data file, or in previous
341        files.  This behavior minimizes clutter in  S\bSP\bPL\bLA\bAT\bT!\b!  gener-
342        ated  topographic  maps,  but also mandates that important
343        locations be placed toward the beginning of the first city
344        data file, and locations less important be positioned fur-
345        ther down the list or in subsequent data files.
346
347        City data files may be generated manually using  any  text
348        editor,  imported from other sources, or derived from data
349        available from the U.S. Census Bureau  using  the  c\bci\bit\bty\byd\bde\be-\b-
350        c\bco\bod\bde\ber\br  utility  included with S\bSP\bPL\bLA\bAT\bT!\b!.  Such data is avail-
351        able free of charge via the Internet  at:  _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bc_\be_\bn_\b-
352        _\bs_\bu_\bs_\b._\bg_\bo_\bv_\b/_\bg_\be_\bo_\b/_\bw_\bw_\bw_\b/_\bc_\bo_\bb_\b/_\bb_\bd_\by_\b__\bf_\bi_\bl_\be_\bs_\b._\bh_\bt_\bm_\bl,  and  must be in ASCII
353        format.
354
355 C\bCA\bAR\bRT\bTO\bOG\bGR\bRA\bAP\bPH\bHI\bIC\bC B\bBO\bOU\bUN\bND\bDA\bAR\bRY\bY D\bDA\bAT\bTA\bA F\bFI\bIL\bLE\bES\bS
356        Cartographic boundary data may also be  imported  to  plot
357        the  boundaries  of  cities,  counties, or states on topo-
358        graphic maps generated by S\bSP\bPL\bLA\bAT\bT!\b!.  Such data  must  be  of
359        the  form  of  ARC/INFO Ungenerate (ASCII Format) Metadata
360        Cartographic Boundary Files, and are  available  from  the
361        U.S.   Census  Bureau via the Internet at: _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bc_\be_\bn_\b-
362        _\bs_\bu_\bs_\b._\bg_\bo_\bv_\b/_\bg_\be_\bo_\b/_\bw_\bw_\bw_\b/_\bc_\bo_\bb_\b/_\bc_\bo_\b2_\b0_\b0_\b0_\b._\bh_\bt_\bm_\bl_\b#_\ba_\bs_\bc_\bi_\bi and  _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bc_\be_\bn_\b-
363        _\bs_\bu_\bs_\b._\bg_\bo_\bv_\b/_\bg_\be_\bo_\b/_\bw_\bw_\bw_\b/_\bc_\bo_\bb_\b/_\bp_\bl_\b2_\b0_\b0_\b0_\b._\bh_\bt_\bm_\bl_\b#_\ba_\bs_\bc_\bi_\bi.   A  total  of five
364        separate cartographic boundary files may be imported at  a
365        time.   It  is not necessary to import state boundaries if
366        county boundaries have already been imported.
367
368 P\bPR\bRO\bOG\bGR\bRA\bAM\bM O\bOP\bPE\bER\bRA\bAT\bTI\bIO\bON\bN
369        S\bSP\bPL\bLA\bAT\bT!\b! is invoked via the command-line using a  series  of
370        switches  and arguments.  Since S\bSP\bPL\bLA\bAT\bT!\b! is a CPU and memory
371        intensive application, this type  of  interface  minimizes
372        overhead  and lends itself well to scripted (batch) opera-
373        tions.  S\bSP\bPL\bLA\bAT\bT!\b!'s CPU and memory scheduling priority may be
374        modified through the use of the Unix n\bni\bic\bce\be command.
375
376        The number and type of switches passed to S\bSP\bPL\bLA\bAT\bT!\b! determine
377        its mode of operation and method of  output  data  genera-
378        tion.   Nearly all of S\bSP\bPL\bLA\bAT\bT!\b!'s switches may be cascaded in
379        any order on the command line when invoking the program.
380
381        S\bSP\bPL\bLA\bAT\bT!\b! operates  in  two  distinct  modes:  _\bp_\bo_\bi_\bn_\bt_\b-_\bt_\bo_\b-_\bp_\bo_\bi_\bn_\bt
382        _\bm_\bo_\bd_\be,  and  _\ba_\br_\be_\ba  _\bp_\br_\be_\bd_\bi_\bc_\bt_\bi_\bo_\bn _\bm_\bo_\bd_\be.  Either a line-of-sight
383        (LOS) or Longley-Rice Irregular Terrain (ITM)  propagation
384        model may be invoked by the user.  True Earth, four-thirds
385        Earth, or any other user-defined Earth radius may be spec-
386        ified when performing line-of-sight analysis.
387
388 P\bPO\bOI\bIN\bNT\bT-\b-T\bTO\bO-\b-P\bPO\bOI\bIN\bNT\bT A\bAN\bNA\bAL\bLY\bYS\bSI\bIS\bS
389        S\bSP\bPL\bLA\bAT\bT!\b! may be used to perform line-of-sight terrain analy-
390        sis between two specified site locations.  For example:
391
392        splat -t tx_site.qth -r rx_site.qth
393
394        invokes  a  line-of-sight  terrain  analysis  between  the
395        transmitter  specified  in _\bt_\bx_\b__\bs_\bi_\bt_\be_\b._\bq_\bt_\bh and receiver speci-
396        fied in _\br_\bx_\b__\bs_\bi_\bt_\be_\b._\bq_\bt_\bh using a True Earth radius  model,  and
397        writes  a S\bSP\bPL\bLA\bAT\bT!\b! Path Analysis Report to the current work-
398        ing directory.  The report contains details of the  trans-
399        mitter  and receiver sites, and identifies the location of
400        any obstructions detected along  the  line-of-sight  path.
401        If  an  obstruction  can be cleared by raising the receive
402        antenna to a greater altitude, S\bSP\bPL\bLA\bAT\bT!\b!  will  indicate  the
403        minimum  antenna  height required for a line-of-sight path
404        to exist between the transmitter  and  receiver  locations
405        specified.   Note  that  imperial  units (miles, feet) are
406        specified unless the _\b-_\bm_\be_\bt_\br_\bi_\bc switch is added  to  S\bSP\bPL\bLA\bAT\bT!\b!'s
407        command line options:
408
409        splat -t tx_site.qth -r rx_site.qth -metric
410
411        If  the  antenna must be raised a significant amount, this
412        determination may take  a  few  moments.   Note  that  the
413        results  provided are the _\bm_\bi_\bn_\bi_\bm_\bu_\bm necessary for a line-of-
414        sight path to exist, and in the case of this simple  exam-
415        ple,  do not take Fresnel zone clearance requirements into
416        consideration.
417
418        _\bq_\bt_\bh extensions are assumed by S\bSP\bPL\bLA\bAT\bT!\b! for  QTH  files,  and
419        are  optional  when  specifying -t and -r arguments on the
420        command-line.  S\bSP\bPL\bLA\bAT\bT!\b! automatically reads all  SPLAT  Data
421        Files  necessary  to  conduct the terrain analysis between
422        the sites specified.  S\bSP\bPL\bLA\bAT\bT!\b!  searches  for  the  required
423        SDF  files in the current working directory first.  If the
424        needed files are not found, S\bSP\bPL\bLA\bAT\bT!\b! then  searches  in  the
425        path specified by the _\b-_\bd command-line switch:
426
427        splat -t tx_site -r rx_site -d /cdrom/sdf/
428
429        An  external  directory path may be specified by placing a
430        ".splat_path" file under the user's home directory.   This
431        file  must  contain the full directory path of last resort
432        to all the SDF files.  The path in  the  _\b$_\bH_\bO_\bM_\bE_\b/_\b._\bs_\bp_\bl_\ba_\bt_\b__\bp_\ba_\bt_\bh
433        file must be of the form of a single line of ASCII text:
434
435        /opt/splat/sdf/
436
437        and can be generated using any text editor.
438
439        A  graph  of  the terrain profile between the receiver and
440        transmitter locations as a function of distance  from  the
441        receiver can be generated by adding the _\b-_\bp switch:
442
443        splat -t tx_site -r rx_site -p terrain_profile.png
444
445        S\bSP\bPL\bLA\bAT\bT!\b!  invokes g\bgn\bnu\bup\bpl\blo\bot\bt when generating graphs.  The file-
446        name extension specified to S\bSP\bPL\bLA\bAT\bT!\b! determines  the  format
447        of  the graph produced.  _\b._\bp_\bn_\bg will produce a 640x480 color
448        PNG graphic file, while _\b._\bp_\bs or  _\b._\bp_\bo_\bs_\bt_\bs_\bc_\br_\bi_\bp_\bt  will  produce
449        postscript  output.   Output in formats such as GIF, Adobe
450        Illustrator, AutoCAD  dxf,  LaTeX,  and  many  others  are
451        available.  Please consult g\bgn\bnu\bup\bpl\blo\bot\bt, and g\bgn\bnu\bup\bpl\blo\bot\bt's documen-
452        tation for details on all the supported output formats.
453
454        A graph of elevations subtended by the terrain between the
455        receiver  and  transmitter  as a function of distance from
456        the receiver can be generated by using the _\b-_\be switch:
457
458        splat -t tx_site -r rx_site -e elevation_profile.png
459
460        The graph produced using this switch illustrates the  ele-
461        vation  and  depression  angles resulting from the terrain
462        between the receiver's location and the  transmitter  site
463        from the perspective of the receiver's location.  A second
464        trace is plotted  between  the  left  side  of  the  graph
465        (receiver's location) and the location of the transmitting
466        antenna on the right.  This trace illustrates  the  eleva-
467        tion  angle  required  for  a  line-of-sight path to exist
468        between the receiver and transmitter  locations.   If  the
469        trace intersects the elevation profile at any point on the
470        graph, then this is an  indication  that  a  line-of-sight
471        path  does  not  exist under the conditions given, and the
472        obstructions can be clearly identified on the graph at the
473        point(s) of intersection.
474
475        A  graph illustrating terrain height referenced to a line-
476        of-sight path between the transmitter and receiver may  be
477        generated using the _\b-_\bh switch:
478
479        splat -t tx_site -r rx_site -h height_profile.png
480
481        A  terrain  height  plot normalized to the transmitter and
482        receiver antenna heights can  be  obtained  using  the  _\b-_\bH
483        switch:
484
485        splat  -t  tx_site  -r  rx_site  -H normalized_height_pro-
486        file.png
487
488        A contour of the Earth's curvature is also plotted in this
489        mode.
490
491        The  first Fresnel Zone, and 60% of the first Fresnel Zone
492        can be added to height profile graphs  by  adding  the  _\b-_\bf
493        switch,  and  specifying a frequency (in MHz) at which the
494        Fresnel Zone should be modeled:
495
496        splat  -t  tx_site  -r  rx_site  -f  439.250  -H   normal-
497        ized_height_profile.png
498
499        Fresnel  Zone  clearances other 60% can be specified using
500        the _\b-_\bf_\bz switch as follows:
501
502        splat  -t  tx_site  -r  rx_site  -f  439.250  -fz  75   -H
503        height_profile2.png
504
505        A  graph  showing  Longley-Rice  path  loss may be plotted
506        using the _\b-_\bl switch:
507
508        splat -t tx_site -r rx_site -l path_loss_profile.png
509
510        As before, adding the _\b-_\bm_\be_\bt_\br_\bi_\bc switch forces the graphs  to
511        be plotted using metric units of measure.
512
513        When  performing  a point-to-point analysis, a S\bSP\bPL\bLA\bAT\bT!\b! Path
514        Analysis Report is generated in the form of  a  text  file
515        with a _\b._\bt_\bx_\bt filename extension.  The report contains bear-
516        ings and distances between the transmitter  and  receiver,
517        as  well  as the free-space and Longley-Rice path loss for
518        the path being analyzed.  The mode of propagation for  the
519        path  is  given  as  _\bL_\bi_\bn_\be_\b-_\bo_\bf_\b-_\bS_\bi_\bg_\bh_\bt, _\bS_\bi_\bn_\bg_\bl_\be _\bH_\bo_\br_\bi_\bz_\bo_\bn, _\bD_\bo_\bu_\bb_\bl_\be
520        _\bH_\bo_\br_\bi_\bz_\bo_\bn, _\bD_\bi_\bf_\bf_\br_\ba_\bc_\bt_\bi_\bo_\bn _\bD_\bo_\bm_\bi_\bn_\ba_\bn_\bt, or _\bT_\br_\bo_\bp_\bo_\bs_\bc_\ba_\bt_\bt_\be_\br _\bD_\bo_\bm_\bi_\bn_\ba_\bn_\bt.
521
522        Distances and locations to known  obstructions  along  the
523        path  between  transmitter and receiver are also provided.
524        If the transmitter's effective radiated power is specified
525        in  the  transmitter's  corresponding _\b._\bl_\br_\bp file, then pre-
526        dicted signal strength and antenna voltage at the  receiv-
527        ing location is also provided in the Path Analysis Report.
528
529        To determine the signal-to-noise  (SNR)  ratio  at  remote
530        location  where random Johnson (thermal) noise is the pri-
531        mary limiting factor in reception:
532
533        _\bS_\bN_\bR=_\bT-_\bN_\bJ-_\bL+_\bG-_\bN_\bF
534
535        where T\bT is the ERP of the transmitter in dBW in the direc-
536        tion of the receiver, N\bNJ\bJ is Johnson Noise in dBW (-136 dBW
537        for a 6 MHz television channel), L\bL is the path  loss  pro-
538        vided  by  S\bSP\bPL\bLA\bAT\bT!\b!   in dB (as a _\bp_\bo_\bs_\bi_\bt_\bi_\bv_\be number), G\bG is the
539        receive antenna gain in dB over isotropic, and N\bNF\bF  is  the
540        receiver noise figure in dB.
541
542        T\bT may be computed as follows:
543
544        _\bT=_\bT_\bI+_\bG_\bT
545
546        where  T\bTI\bI  is  actual  amount of RF power delivered to the
547        transmitting  antenna  in  dBW,  G\bGT\bT  is  the  transmitting
548        antenna  gain  (over  isotropic)  in  the direction of the
549        receiver (or the horizon if the receiver is over the hori-
550        zon).
551
552        To compute how much more signal is available over the min-
553        imum to necessary to achieve  a  specific  signal-to-noise
554        ratio:
555
556        _\bS_\bi_\bg_\bn_\ba_\bl__\bM_\ba_\br_\bg_\bi_\bn=_\bS_\bN_\bR-_\bS
557
558        where  S\bS  is  the  minimum required SNR ratio (15.5 dB for
559        ATSC (8-level VSB) DTV, 42 dB for analog NTSC television).
560
561        A  topographic map may be generated by S\bSP\bPL\bLA\bAT\bT!\b! to visualize
562        the path between the transmitter and receiver  sites  from
563        yet  another  perspective.   Topographic maps generated by
564        S\bSP\bPL\bLA\bAT\bT!\b! display elevations using a  logarithmic  grayscale,
565        with higher elevations represented through brighter shades
566        of gray.  The dynamic range of the image is scaled between
567        the highest and lowest elevations present in the map.  The
568        only exception to this is sea-level, which is  represented
569        using the color blue.
570
571        Topographic output is invoked using the _\b-_\bo switch:
572
573        splat -t tx_site -r rx_site -o topo_map.ppm
574
575        The  _\b._\bp_\bp_\bm  extension  on the output filename is assumed by
576        S\bSP\bPL\bLA\bAT\bT!\b!, and is optional.
577
578        In this example, _\bt_\bo_\bp_\bo_\b__\bm_\ba_\bp_\b._\bp_\bp_\bm will  illustrate  the  loca-
579        tions of the transmitter and receiver sites specified.  In
580        addition, the great circle path between the two sites will
581        be  drawn  over  locations  for which an unobstructed path
582        exists to the transmitter at a  receiving  antenna  height
583        equal   to   that  of  the  receiver  site  (specified  in
584        _\br_\bx_\b__\bs_\bi_\bt_\be_\b._\bq_\bt_\bh).
585
586        It may desirable to  populate  the  topographic  map  with
587        names  and  locations  of  cities,  tower  sites, or other
588        important locations.  A city file may be passed to  S\bSP\bPL\bLA\bAT\bT!\b!
589        using the _\b-_\bs switch:
590
591        splat -t tx_site -r rx_site -s cities.dat -o topo_map
592
593        Up  to five separate city files may be passed to S\bSP\bPL\bLA\bAT\bT!\b! at
594        a time following the _\b-_\bs switch.
595
596        County and state boundaries may be added  to  the  map  by
597        specifying  up  to  five  U.S.  Census Bureau cartographic
598        boundary files using the _\b-_\bb switch:
599
600        splat -t tx_site -r rx_site -b co34_d00.dat -o topo_map
601
602        In situations where multiple transmitter sites are in use,
603        as  many as four site locations may be passed to S\bSP\bPL\bLA\bAT\bT!\b! at
604        a time for analysis:
605
606        splat -t tx_site1 tx_site2 tx_site3 tx_site4 -r rx_site -p
607        profile.png
608
609        In  this  example,  four  separate  terrain  profiles  and
610        obstruction reports will be generated by S\bSP\bPL\bLA\bAT\bT!\b!.  A single
611        topographic  map can be specified using the _\b-_\bo switch, and
612        line-of-sight  paths  between  each  transmitter  and  the
613        receiver  site indicated will be produced on the map, each
614        in its own color.  The path between the first  transmitter
615        specified  to  the  receiver  will  be  in green, the path
616        between the second transmitter and the receiver will be in
617        cyan,  the  path  between  the  third  transmitter and the
618        receiver will be in  violet,  and  the  path  between  the
619        fourth transmitter and the receiver will be in sienna.
620
621        S\bSP\bPL\bLA\bAT\bT!\b!  generated  topographic  maps  are 24-bit TrueColor
622        Portable PixMap (PPM) images.  They may be viewed, edited,
623        or  converted  to  other  graphic formats by popular image
624        viewing applications such as x\bxv\bv,  T\bTh\bhe\be  G\bGI\bIM\bMP\bP,  I\bIm\bma\bag\bge\beM\bMa\bag\bgi\bic\bck\bk,
625        and X\bXP\bPa\bai\bin\bnt\bt.  PNG format is highly recommended for lossless
626        compressed storage of S\bSP\bPL\bLA\bAT\bT!\b!  generated topographic output
627        files.  I\bIm\bma\bag\bge\beM\bMa\bag\bgi\bic\bck\bk's command-line utility easily converts
628        S\bSP\bPL\bLA\bAT\bT!\b!'s PPM files to PNG format:
629
630        convert splat_map.ppm splat_map.png
631
632        Another excellent  PPM  to  PNG  command-line  utility  is
633        available                                              at:
634        _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bl_\bi_\bb_\bp_\bn_\bg_\b._\bo_\br_\bg_\b/_\bp_\bu_\bb_\b/_\bp_\bn_\bg_\b/_\bb_\bo_\bo_\bk_\b/_\bs_\bo_\bu_\br_\bc_\be_\bs_\b._\bh_\bt_\bm_\bl.    As   a
635        last  resort,  PPM files may be compressed using the bzip2
636        utility, and read directly by T\bTh\bhe\be G\bGI\bIM\bMP\bP in this format.
637
638        The _\b-_\bn_\bg_\bs option assigns all terrain to  the  color  white,
639        and  can  be  used  when it is desirable to generate a map
640        that is devoid of terrain:
641
642        splat -t  tx_site  -r  rx_site  -b  co34_d00.dat  -ngs  -o
643        white_map
644
645        The  resulting  .ppm  image  file can be converted to .png
646        format with a transparent background  using  I\bIm\bma\bag\bge\beM\bMa\bag\bgi\bic\bck\bk's
647        c\bco\bon\bnv\bve\ber\brt\bt utility:
648
649        convert  -transparent  "#FFFFFF"  white_map.ppm  transpar-
650        ent_map.png
651
652 R\bRE\bEG\bGI\bIO\bON\bNA\bAL\bL C\bCO\bOV\bVE\bER\bRA\bAG\bGE\bE A\bAN\bNA\bAL\bLY\bYS\bSI\bIS\bS
653        S\bSP\bPL\bLA\bAT\bT!\b! can analyze a transmitter or repeater site, or net-
654        work  of sites, and predict the regional coverage for each
655        site specified.  In this mode, S\bSP\bPL\bLA\bAT\bT!\b! can generate a topo-
656        graphic  map displaying the geometric line-of-sight cover-
657        age area of the sites based on the location of  each  site
658        and  the  height of receive antenna wishing to communicate
659        with the site in question.  A  regional  analysis  may  be
660        performed by S\bSP\bPL\bLA\bAT\bT!\b! using the _\b-_\bc switch as follows:
661
662        splat  -t tx_site -c 30.0 -s cities.dat -b co34_d00.dat -o
663        tx_coverage
664
665        In this example, S\bSP\bPL\bLA\bAT\bT!\b! generates a topographic map called
666        _\bt_\bx_\b__\bc_\bo_\bv_\be_\br_\ba_\bg_\be_\b._\bp_\bp_\bm  that  illustrates  the predicted line-of-
667        sight regional coverage of _\bt_\bx_\b__\bs_\bi_\bt_\be to receiving  locations
668        having  antennas  30.0  feet above ground level (AGL).  If
669        the _\b-_\bm_\be_\bt_\br_\bi_\bc switch is used, the argument following the  _\b-_\bc
670        switch  is  interpreted  as being in meters rather than in
671        feet.  The contents of _\bc_\bi_\bt_\bi_\be_\bs_\b._\bd_\ba_\bt are plotted on the  map,
672        as  are  the cartographic boundaries contained in the file
673        _\bc_\bo_\b3_\b4_\b__\bd_\b0_\b0_\b._\bd_\ba_\bt.
674
675        When plotting line-of-sight paths and  areas  of  regional
676        coverage,  S\bSP\bPL\bLA\bAT\bT!\b!  by  default  does  not  account for the
677        effects of atmospheric bending.   However,  this  behavior
678        may  be modified by using the Earth radius multiplier (_\b-_\bm)
679        switch:
680
681        splat -t wnjt-dt -c 30.0 -m 1.333 -s cities.dat  -b  coun-
682        ties.dat -o map.ppm
683
684        An  earth  radius  multiplier of 1.333 instructs S\bSP\bPL\bLA\bAT\bT!\b! to
685        use the "four-thirds earth" model for line-of-sight propa-
686        gation  analysis.  Any appropriate earth radius multiplier
687        may be selected by the user.
688
689        When performing a regional analysis,  S\bSP\bPL\bLA\bAT\bT!\b!  generates  a
690        site  report  for  each  station  analyzed.   S\bSP\bPL\bLA\bAT\bT!\b!  site
691        reports contain details of the site's geographic location,
692        its  height  above  mean  sea  level, the antenna's height
693        above mean sea level, the antenna's height  above  average
694        terrain,  and the height of the average terrain calculated
695        toward the bearings of 0, 45, 90, 135, 180, 225, 270,  and
696        315 degrees azimuth.
697
698 D\bDE\bET\bTE\bER\bRM\bMI\bIN\bNI\bIN\bNG\bG M\bMU\bUL\bLT\bTI\bIP\bPL\bLE\bE R\bRE\bEG\bGI\bIO\bON\bNS\bS O\bOF\bF L\bLO\bOS\bS C\bCO\bOV\bVE\bER\bRA\bAG\bGE\bE
699        S\bSP\bPL\bLA\bAT\bT!\b!  can  also display line-of-sight coverage areas for
700        as many as four separate transmitter  sites  on  a  common
701        topographic map.  For example:
702
703        splat  -t  site1 site2 site3 site4 -c 10.0 -metric -o net-
704        work.ppm
705
706        plots the regional line-of-sight coverage of site1, site2,
707        site3,  and  site4 based on a receive antenna located 10.0
708        meters above ground level.   A  topographic  map  is  then
709        written to the file _\bn_\be_\bt_\bw_\bo_\br_\bk_\b._\bp_\bp_\bm.  The line-of-sight cover-
710        age area of the transmitters are plotted as follows in the
711        colors  indicated (along with their corresponding RGB val-
712        ues in decimal):
713
714            site1: Green (0,255,0)
715            site2: Cyan (0,255,255)
716            site3: Medium Violet (147,112,219)
717            site4: Sienna 1 (255,130,71)
718
719            site1 + site2: Yellow (255,255,0)
720            site1 + site3: Pink (255,192,203)
721            site1 + site4: Green Yellow (173,255,47)
722            site2 + site3: Orange (255,165,0)
723            site2 + site4: Dark Sea Green 1 (193,255,193)
724            site3 + site4: Dark Turquoise (0,206,209)
725
726            site1 + site2 + site3: Dark Green (0,100,0)
727            site1 + site2 + site4: Blanched Almond (255,235,205)
728            site1 + site3 + site4: Medium Spring Green (0,250,154)
729            site2 + site3 + site4: Tan (210,180,140)
730
731            site1 + site2 + site3 + site4: Gold2 (238,201,0)
732
733        If  separate _\b._\bq_\bt_\bh files are generated, each representing a
734        common site location but a  different  antenna  height,  a
735        single  topographic map illustrating the regional coverage
736        from as many as four separate locations on a single  tower
737        may be generated by S\bSP\bPL\bLA\bAT\bT!\b!.
738
739 L\bLO\bON\bNG\bGL\bLE\bEY\bY-\b-R\bRI\bIC\bCE\bE P\bPA\bAT\bTH\bH L\bLO\bOS\bSS\bS A\bAN\bNA\bAL\bLY\bYS\bSI\bIS\bS
740        If  the  _\b-_\bc  switch is replaced by a _\b-_\bL switch, a Longley-
741        Rice path loss map for a transmitter site  may  be  gener-
742        ated:
743
744        splat  -t  wnjt  -L  30.0 -s cities.dat -b co34_d00.dat -o
745        path_loss_map
746
747        In this mode, S\bSP\bPL\bLA\bAT\bT!\b! generates a  multi-color  map  illus-
748        trating  expected  signal  levels in areas surrounding the
749        transmitter site.  A legend at the bottom of the map  cor-
750        relates  each  color  with  a  specific path loss range in
751        decibels or signal strength in decibels over one microvolt
752        per meter (dBuV/m).
753
754        The Longley-Rice analysis range may be modified to a user-
755        specific value using the _\b-_\bR switch.  The argument must  be
756        given  in  miles  (or  kilometers if the _\b-_\bm_\be_\bt_\br_\bi_\bc switch is
757        used).  If a range wider than  the  generated  topographic
758        map  is  specified,  S\bSP\bPL\bLA\bAT\bT!\b! will perform Longley-Rice path
759        loss calculations between all four  corners  of  the  area
760        prediction map.
761
762        The  _\b-_\bd_\bb  switch  allows  a constraint to be placed on the
763        maximum path loss region plotted on the  map.   A  maximum
764        path  loss  between  80  and 230 dB may be specified using
765        this switch.  For example, if a path loss beyond  -140  dB
766        is irrelevant to the survey being conducted, S\bSP\bPL\bLA\bAT\bT!\b!'s path
767        loss plot can be constrained to the region bounded by  the
768        140 dB attenuation contour as follows:
769
770        splat -t wnjt-dt -L 30.0 -s cities.dat -b co34_d00.dat -db
771        140 -o plot.ppm
772
773
774 S\bSI\bIG\bGN\bNA\bAL\bL C\bCO\bON\bNT\bTO\bOU\bUR\bR C\bCO\bOL\bLO\bOR\bR D\bDE\bEF\bFI\bIN\bNI\bIT\bTI\bIO\bON\bN P\bPA\bAR\bRA\bAM\bME\bET\bTE\bER\bRS\bS
775        The colors used to illustrate  signal  strength  and  path
776        loss  contours  in  S\bSP\bPL\bLA\bAT\bT!\b!  generated coverage maps may be
777        tailored by the user by  creating  or  modifying  S\bSP\bPL\bLA\bAT\bT!\b!'s
778        color  definition  files.   S\bSP\bPL\bLA\bAT\bT!\b!  color definition files
779        have the same base name as the  transmitter's  _\b._\bq_\bt_\bh  file,
780        but carry _\b._\bl_\bc_\bf and _\b._\bs_\bc_\bf extensions.
781
782        When a regional Longley-Rice analysis is performed and the
783        transmitter's ERP is not specified or is zero, a _\b._\bl_\bc_\bf path
784        loss  color definition file corresponding to the transmit-
785        ter site (_\b._\bq_\bt_\bh) is read by S\bSP\bPL\bLA\bAT\bT!\b! from the current working
786        directory.   If a _\b._\bl_\bc_\bf file corresponding to the transmit-
787        ter site is not found, then a default  file  suitable  for
788        manual  editing  by the user is automatically generated by
789        S\bSP\bPL\bLA\bAT\bT!\b!.  If the transmitter's ERP  is  specified,  then  a
790        signal  strength  map  is  generated and a signal strength
791        color definition file (_\b._\bs_\bc_\bf) is read, or generated if  one
792        is not available in the current working directory.
793
794        A  path-loss color definition file possesses the following
795        structure (_\bw_\bn_\bj_\bt_\b-_\bd_\bt_\b._\bl_\bc_\bf):
796
797         ;  SPLAT!  Auto-generated  Path-Loss   Color   Definition
798        ("wnjt-dt.lcf") File
799         ;
800         ;  Format for the parameters held in this file is as fol-
801        lows:
802         ;
803         ;    dB: red, green, blue
804         ;
805         ; ...where "dB" is the path loss (in dB) and
806         ; "red", "green", and "blue" are  the  corresponding  RGB
807        color
808         ; definitions ranging from 0 to 255 for the region speci-
809        fied.
810         ;
811         ; The following parameters may be edited and/or expanded
812         ; for future runs  of  SPLAT!   A  total  of  32  contour
813        regions
814         ; may be defined in this file.
815         ;
816         ;
817          80: 255,   0,   0
818          90: 255, 128,   0
819         100: 255, 165,   0
820         110: 255, 206,   0
821         120: 255, 255,   0
822         130: 184, 255,   0
823         140:   0, 255,   0
824         150:   0, 208,   0
825         160:   0, 196, 196
826         170:   0, 148, 255
827         180:  80,  80, 255
828         190:   0,  38, 255
829         200: 142,  63, 255
830         210: 196,  54, 255
831         220: 255,   0, 255
832         230: 255, 194, 204
833
834
835        If  the path loss is less than 80 dB, the color Red (RGB =
836        255, 0, 0) is assigned to the region.  If the path-loss is
837        greater  than or equal to 80 dB, but less than 90 db, then
838        Dark Orange (255, 128,  0)  is  assigned  to  the  region.
839        Orange  (255, 165, 0) is assigned to regions having a path
840        loss greater than or equal to 90 dB, but less than 100 dB,
841        and  so on.  Greyscale terrain is displayed beyond the 230
842        dB path loss contour.
843
844        S\bSP\bPL\bLA\bAT\bT!\b! signal strength color definition files share a very
845        similar structure (_\bw_\bn_\bj_\bt_\b-_\bd_\bt_\b._\bs_\bc_\bf):
846
847         ;  SPLAT!  Auto-generated Signal Color Definition ("wnjt-
848        dt.scf") File
849         ;
850         ; Format for the parameters held in this file is as  fol-
851        lows:
852         ;
853         ;    dBuV/m: red, green, blue
854         ;
855         ;  ...where  "dBuV/m"  is the signal strength (in dBuV/m)
856        and
857         ; "red", "green", and "blue" are  the  corresponding  RGB
858        color
859         ; definitions ranging from 0 to 255 for the region speci-
860        fied.
861         ;
862         ; The following parameters may be edited and/or expanded
863         ; for future runs  of  SPLAT!   A  total  of  32  contour
864        regions
865         ; may be defined in this file.
866         ;
867         ;
868         128: 255,   0,   0
869         118: 255, 165,   0
870         108: 255, 206,   0
871          98: 255, 255,   0
872          88: 184, 255,   0
873          78:   0, 255,   0
874          68:   0, 208,   0
875          58:   0, 196, 196
876          48:   0, 148, 255
877          38:  80,  80, 255
878          28:   0,  38, 255
879          18: 142,  63, 255
880           8: 140,   0, 128
881
882
883        If  the signal strength is greater than or equal to 128 db
884        over 1 microvolt per meter (dBuV/m), the color  Red  (255,
885        0, 0) is displayed for the region.  If the signal strength
886        is greater than or equal to 118 dbuV/m, but less than  128
887        dbuV/m,  then the color Orange (255, 165, 0) is displayed,
888        and so on.  Greyscale terrain  is  displayed  for  regions
889        with signal strengths less than 8 dBuV/m.
890
891        Signal  strength  contours  for  some  common  VHF and UHF
892        broadcasting services in the United States are as follows:
893
894               Analog Television Broadcasting
895               ------------------------------
896               Channels 2-6:       City Grade: >= 74 dBuV/m
897                                      Grade A: >= 68 dBuV/m
898                                      Grade B: >= 47 dBuV/m
899               --------------------------------------------
900               Channels 7-13:      City Grade: >= 77 dBuV/m
901                                      Grade A: >= 71 dBuV/m
902                                      Grade B: >= 56 dBuV/m
903               --------------------------------------------
904               Channels 14-69:   Indoor Grade: >= 94 dBuV/m
905                                   City Grade: >= 80 dBuV/m
906                                      Grade A: >= 74 dBuV/m
907                                      Grade B: >= 64 dBuV/m
908
909               Digital Television Broadcasting
910               -------------------------------
911               Channels 2-6:       City Grade: >= 35 dBuV/m
912                            Service Threshold: >= 28 dBuV/m
913               --------------------------------------------
914               Channels 7-13:      City Grade: >= 43 dBuV/m
915                            Service Threshold: >= 36 dBuV/m
916               --------------------------------------------
917               Channels 14-69:     City Grade: >= 48 dBuV/m
918                            Service Threshold: >= 41 dBuV/m
919
920               NOAA Weather Radio (162.400 - 162.550 MHz)
921               ------------------------------------------
922                          Reliable: >= 18 dBuV/m
923                      Not reliable: <  18 dBuV/m
924               Unlikely to receive: <  0 dBuV/m
925
926               FM Radio Broadcasting (88.1 - 107.9 MHz)
927               ----------------------------------------
928               Analog Service Contour:  60 dBuV/m
929               Digital Service Contour: 65 dBuV/m
930
931
932
933 A\bAN\bNT\bTE\bEN\bNN\bNA\bA R\bRA\bAD\bDI\bIA\bAT\bTI\bIO\bON\bN P\bPA\bAT\bTT\bTE\bER\bRN\bN P\bPA\bAR\bRA\bAM\bME\bET\bTE\bER\bRS\bS
934        Normalized  field  voltage  patterns  for  a  transmitting
935        antenna's horizontal  and  vertical  planes  are  imported
936        automatically  into  S\bSP\bPL\bLA\bAT\bT!\b!  when  a Longley-Rice coverage
937        analysis is performed.  Antenna pattern data is read  from
938        a pair of files having the same base name as the transmit-
939        ter and LRP files, but with _\b._\ba_\bz  and  _\b._\be_\bl  extensions  for
940        azimuth and elevation pattern files, respectively.  Speci-
941        fications regarding pattern rotation (if any) and mechani-
942        cal  beam  tilt  and tilt direction (if any) are also con-
943        tained within S\bSP\bPL\bLA\bAT\bT!\b! antenna pattern files.
944
945        For example, the first few lines of a S\bSP\bPL\bLA\bAT\bT!\b! azimuth  pat-
946        tern file might appear as follows (_\bk_\bv_\be_\ba_\b._\ba_\bz):
947
948                183.0
949                0       0.8950590
950                1       0.8966406
951                2       0.8981447
952                3       0.8995795
953                4       0.9009535
954                5       0.9022749
955                6       0.9035517
956                7       0.9047923
957                8       0.9060051
958
959        The  first  line  of  the _\b._\ba_\bz file specifies the amount of
960        azimuthal pattern rotation (measured clockwise in  degrees
961        from  True North) to be applied by S\bSP\bPL\bLA\bAT\bT!\b! to the data con-
962        tained in the _\b._\ba_\bz file.  This is followed by azimuth head-
963        ings  (0  to  360 degrees) and their associated normalized
964        field patterns (0.000 to 1.000) separated by whitespace.
965
966        The  structure  of  S\bSP\bPL\bLA\bAT\bT!\b!  elevation  pattern  files   is
967        slightly different.  The first line of the _\b._\be_\bl file speci-
968        fies the amount of mechanical beam  tilt  applied  to  the
969        antenna.  Note that a _\bd_\bo_\bw_\bn_\bw_\ba_\br_\bd _\bt_\bi_\bl_\bt (below the horizon) is
970        expressed as a _\bp_\bo_\bs_\bi_\bt_\bi_\bv_\be _\ba_\bn_\bg_\bl_\be, while an _\bu_\bp_\bw_\ba_\br_\bd _\bt_\bi_\bl_\bt (above
971        the  horizon) is expressed as a _\bn_\be_\bg_\ba_\bt_\bi_\bv_\be _\ba_\bn_\bg_\bl_\be.  This data
972        is followed by the azimuthal direction of the tilt,  sepa-
973        rated by whitespace.
974
975        The remainder of the file consists of elevation angles and
976        their corresponding normalized voltage  radiation  pattern
977        (0.000  to  1.000) values separated by whitespace.  Eleva-
978        tion angles must be specified over a -10.0 to +90.0 degree
979        range.   As  was  the convention with mechanical beamtilt,
980        _\bn_\be_\bg_\ba_\bt_\bi_\bv_\be _\be_\bl_\be_\bv_\ba_\bt_\bi_\bo_\bn _\ba_\bn_\bg_\bl_\be_\bs are used to represent elevations
981        _\ba_\bb_\bo_\bv_\be _\bt_\bh_\be _\bh_\bo_\br_\bi_\bz_\bo_\bn, while _\bp_\bo_\bs_\bi_\bt_\bi_\bv_\be _\ba_\bn_\bg_\bl_\be_\bs represents eleva-
982        tions _\bb_\be_\bl_\bo_\bw _\bt_\bh_\be _\bh_\bo_\br_\bi_\bz_\bo_\bn.
983
984        For example, the first few lines a S\bSP\bPL\bLA\bAT\bT!\b!  elevation  pat-
985        tern file might appear as follows (_\bk_\bv_\be_\ba_\b._\be_\bl):
986
987                1.1    130.0
988               -10.0   0.172
989               -9.5    0.109
990               -9.0    0.115
991               -8.5    0.155
992               -8.0    0.157
993               -7.5    0.104
994               -7.0    0.029
995               -6.5    0.109
996               -6.0    0.185
997
998        In  this example, the antenna is mechanically tilted down-
999        ward 1.1 degrees towards an azimuth of 130.0 degrees.
1000
1001        For best results, the resolution of azimuth  pattern  data
1002        should  be  specified  to  the nearest degree azimuth, and
1003        elevation pattern data resolution should be  specified  to
1004        the  nearest  0.01 degrees.  If the pattern data specified
1005        does not reach  this  level  of  resolution,  S\bSP\bPL\bLA\bAT\bT!\b!  will
1006        interpolate  the  values provided to determine the data at
1007        the required resolution, although this  may  result  in  a
1008        loss in accuracy.
1009
1010
1011 I\bIM\bMP\bPO\bOR\bRT\bTI\bIN\bNG\bG A\bAN\bND\bD E\bEX\bXP\bPO\bOR\bRT\bTI\bIN\bNG\bG R\bRE\bEG\bGI\bIO\bON\bNA\bAL\bL P\bPA\bAT\bTH\bH L\bLO\bOS\bSS\bS C\bCO\bON\bNT\bTO\bOU\bUR\bR D\bDA\bAT\bTA\bA
1012        Performing  a Longley-Rice coverage analysis can be a very
1013        time consuming process,  especially  if  the  analysis  is
1014        repeated  repeatedly  to  discover what effects changes to
1015        the antenna radiation patterns make to the predicted  cov-
1016        erage area.
1017
1018        This  process  can  be expedited by exporting the Longley-
1019        Rice regional path loss contour data to  an  output  file,
1020        modifying  the  path  loss  data externally to incorporate
1021        antenna pattern effects, and then importing  the  modified
1022        path  loss  data  back  into  S\bSP\bPL\bLA\bAT\bT!\b!  to rapidly produce a
1023        revised path loss map.
1024
1025        For example, a path loss output file can be  generated  by
1026        S\bSP\bPL\bLA\bAT\bT!\b!  for a receive site 30 feet above ground level over
1027        a 50 mile radius surrounding a transmitter site to a maxi-
1028        mum path loss of 140 dB using the following syntax:
1029
1030        splat -t kvea -L 30.0 -R 50.0 -db 140 -plo pathloss.dat
1031
1032        S\bSP\bPL\bLA\bAT\bT!\b!  path  loss output files often exceed 100 megabytes
1033        in size.  They contain information relating to the  bound-
1034        aries  of  region  they  describe  followed  by  latitudes
1035        (degrees North), longitudes (degrees West), azimuths, ele-
1036        vations  (to the first obstruction), and path loss figures
1037        (dB) for a series of specific  points  that  comprise  the
1038        region  surrounding  the  transmitter site.  The first few
1039        lines of a S\bSP\bPL\bLA\bAT\bT!\b! path loss output file take on  the  fol-
1040        lowing appearance (_\bp_\ba_\bt_\bh_\bl_\bo_\bs_\bs_\b._\bd_\ba_\bt):
1041
1042                119, 117    ; max_west, min_west
1043                35, 33      ; max_north, min_north
1044                34.2265434, 118.0631104, 48.171, -37.461, 67.70
1045                34.2270355, 118.0624390, 48.262, -26.212, 73.72
1046                34.2280197, 118.0611038, 48.269, -14.951, 79.74
1047                34.2285156, 118.0604401, 48.207, -11.351, 81.68
1048                34.2290077, 118.0597687, 48.240, -10.518, 83.26
1049                34.2294998, 118.0591049, 48.225, 23.201, 84.60
1050                34.2304878, 118.0577698, 48.213, 15.769, 137.84
1051                34.2309799, 118.0570984, 48.234, 15.965, 151.54
1052                34.2314720, 118.0564346, 48.224, 16.520, 149.45
1053                34.2319679, 118.0557632, 48.223, 15.588, 151.61
1054                34.2329521, 118.0544281, 48.230, 13.889, 135.45
1055                34.2334442, 118.0537643, 48.223, 11.693, 137.37
1056                34.2339401, 118.0530930, 48.222, 14.050, 126.32
1057                34.2344322, 118.0524292, 48.216, 16.274, 156.28
1058                34.2354164, 118.0510941, 48.222, 15.058, 152.65
1059                34.2359123, 118.0504227, 48.221, 16.215, 158.57
1060                34.2364044, 118.0497589, 48.216, 15.024, 157.30
1061                34.2368965, 118.0490875, 48.225, 17.184, 156.36
1062
1063        It  is  not uncommon for S\bSP\bPL\bLA\bAT\bT!\b! path loss files to contain
1064        as many as 3 million or more lines of data.  Comments  can
1065        be placed in the file if they are proceeded by a semicolon
1066        character.  The v\bvi\bim\bm text  editor  has  proven  capable  of
1067        editing files of this size.
1068
1069        Note  as  was the case in the antenna pattern files, nega-
1070        tive elevation angles refer  to  upward  tilt  (above  the
1071        horizon),  while  positive  angles  refer to downward tilt
1072        (below the horizon).  These angles refer to the  elevation
1073        to  the receiving antenna at the height above ground level
1074        specified using the _\b-_\bL switch _\bi_\bf the path  between  trans-
1075        mitter  and receiver is unobstructed.  If the path between
1076        the transmitter and receiver is obstructed, then the  ele-
1077        vation  angle  to  the  first  obstruction  is returned by
1078        S\bSP\bPL\bLA\bAT\bT!\b!.  This is because the Longley-Rice model  considers
1079        the  energy  reaching  a  distant point over an obstructed
1080        path as a derivative of the energy scattered from the  top
1081        of the first obstruction, only.  Since energy cannot reach
1082        the obstructed location  directly,  the  actual  elevation
1083        angle to that point is irrelevant.
1084
1085        When  modifying  S\bSP\bPL\bLA\bAT\bT!\b! path loss files to reflect antenna
1086        pattern data, _\bo_\bn_\bl_\by _\bt_\bh_\be _\bl_\ba_\bs_\bt _\bc_\bo_\bl_\bu_\bm_\bn _\b(_\bp_\ba_\bt_\bh _\bl_\bo_\bs_\bs_\b)  should  be
1087        amended  to  reflect  the antenna's normalized gain at the
1088        azimuth and elevation angles specified in the  file.   (At
1089        this time, programs and scripts capable of performing this
1090        operation are left as an exercise for the user.)
1091
1092        Modified path loss maps can be imported back  into  S\bSP\bPL\bLA\bAT\bT!\b!
1093        for generating revised coverage maps:
1094
1095        splat  -t kvea -pli pathloss.dat -s city.dat -b county.dat
1096        -o map.ppm
1097
1098        S\bSP\bPL\bLA\bAT\bT!\b! path loss files can also  be  used  for  conducting
1099        coverage or interference studies outside of S\bSP\bPL\bLA\bAT\bT!\b!.
1100
1101 U\bUS\bSE\bER\bR-\b-D\bDE\bEF\bFI\bIN\bNE\bED\bD T\bTE\bER\bRR\bRA\bAI\bIN\bN I\bIN\bNP\bPU\bUT\bT F\bFI\bIL\bLE\bES\bS
1102        A  user-defined terrain file is a user-generated text file
1103        containing latitudes, longitudes, and heights above ground
1104        level  of  specific  terrain  features  believed  to be of
1105        importance to the S\bSP\bPL\bLA\bAT\bT!\b!  analysis  being  conducted,  but
1106        noticeably  absent from the SDF files being used.  A user-
1107        defined terrain file is imported into  a  S\bSP\bPL\bLA\bAT\bT!\b!  analysis
1108        using the _\b-_\bu_\bd_\bt switch:
1109
1110         splat -t tx_site -r rx_site -udt udt_file.txt -o map.ppm
1111
1112        A  user-defined  terrain file has the following appearance
1113        and structure:
1114
1115               40.32180556, 74.1325, 100.0 meters
1116               40.321805, 74.1315, 300.0
1117               40.3218055, 74.1305, 100.0 meters
1118
1119        Terrain height is interpreted as being described  in  feet
1120        above ground level unless followed by the word _\bm_\be_\bt_\be_\br_\bs, and
1121        is added _\bo_\bn _\bt_\bo_\bp _\bo_\bf the terrain specified in the  SDF  data
1122        for  the  locations  specified.   Be aware that each user-
1123        defined terrain feature specified will be  interpreted  as
1124        being  3-arc seconds in both latitude and longitude.  Fea-
1125        tures described in  the  user-defined  terrain  file  that
1126        overlap  previously  defined  features  in  the  file  are
1127        ignored by S\bSP\bPL\bLA\bAT\bT!\b!.
1128
1129 S\bSI\bIM\bMP\bPL\bLE\bE T\bTO\bOP\bPO\bOG\bGR\bRA\bAP\bPH\bHI\bIC\bC M\bMA\bAP\bP G\bGE\bEN\bNE\bER\bRA\bAT\bTI\bIO\bON\bN
1130        In certain situations it may be desirable  to  generate  a
1131        topographic  map  of  a  region  without plotting coverage
1132        areas,  line-of-sight  paths,  or  generating  obstruction
1133        reports.   There  are  several ways of doing this.  If one
1134        wishes to generate  a  topographic  map  illustrating  the
1135        location  of  a transmitter and receiver site along with a
1136        brief text report describing the locations  and  distances
1137        between the sites, the _\b-_\bn switch should be invoked as fol-
1138        lows:
1139
1140        splat -t tx_site -r rx_site -n -o topo_map.ppm
1141
1142        If no text report is desired, then the _\b-_\bN switch is used:
1143
1144        splat -t tx_site -r rx_site -N -o topo_map.ppm
1145
1146        If a topographic map centered about a single site out to a
1147        minimum  specified  radius  is  desired instead, a command
1148        similar to the following can be used:
1149
1150        splat -t tx_site -R 50.0 -s NJ_Cities  -b  NJ_Counties  -o
1151        topo_map.ppm
1152
1153        where  -R specifies the minimum radius of the map in miles
1154        (or kilometers if the _\b-_\bm_\be_\bt_\br_\bi_\bc switch is used).  Note  that
1155        the  tx_site  name  and location are not displayed in this
1156        example.  If display of this information is desired,  sim-
1157        ply create a S\bSP\bPL\bLA\bAT\bT!\b! city file (_\b-_\bs option) and append it to
1158        the list of command-line options illustrated above.
1159
1160        If the _\b-_\bo switch and output filename are omitted in  these
1161        operations,  topographic output is written to a file named
1162        _\bt_\bx_\b__\bs_\bi_\bt_\be_\b._\bp_\bp_\bm in the current working directory by default.
1163
1164 G\bGE\bEO\bOR\bRE\bEF\bFE\bER\bRE\bEN\bNC\bCE\bE F\bFI\bIL\bLE\bE G\bGE\bEN\bNE\bER\bRA\bAT\bTI\bIO\bON\bN
1165        Topographic, coverage (_\b-_\bc), and  path  loss  contour  (_\b-_\bL)
1166        maps  generated  by  S\bSP\bPL\bLA\bAT\bT!\b! may be imported into X\bXa\bas\bst\bti\bir\br (X
1167        Amateur Station Tracking and Information Reporting)  soft-
1168        ware by generating a georeference file using S\bSP\bPL\bLA\bAT\bT!\b!'s _\b-_\bg_\be_\bo
1169        switch:
1170
1171        splat -t kd2bd -R 50.0 -s NJ_Cities -b NJ_Counties -geo -o
1172        map.ppm
1173
1174        The  georeference  file  generated will have the same base
1175        name as the _\b-_\bo file specified, but have a  _\b._\bg_\be_\bo extension,
1176        and  permit  proper interpretation and display of S\bSP\bPL\bLA\bAT\bT!\b!'s
1177        .ppm graphics in X\bXa\bas\bst\bti\bir\br software.
1178
1179 G\bGO\bOO\bOG\bGL\bLE\bE M\bMA\bAP\bP K\bKM\bML\bL F\bFI\bIL\bLE\bE G\bGE\bEN\bNE\bER\bRA\bAT\bTI\bIO\bON\bN
1180        Keyhole Markup Language files compatible with G\bGo\boo\bog\bgl\ble\be E\bEa\bar\brt\bth\bh
1181        may  be generated by S\bSP\bPL\bLA\bAT\bT!\b! when performing point-to-point
1182        or regional coverage analyses by invoking the _\b-_\bk_\bm_\bl switch:
1183
1184        splat -t wnjt-dt -r kd2bd -kml
1185
1186        The  KML file generated will have the same filename struc-
1187        ture as a Path Analysis Report  for  the  transmitter  and
1188        receiver  site  names  given, except it will carry a  _\b._\bk_\bm_\bl
1189        extension.
1190
1191        Once loaded into G\bGo\boo\bog\bgl\ble\be E\bEa\bar\brt\bth\bh (File  -->  Open),  the  KML
1192        file  will  annotate the map display with the names of the
1193        transmitter and receiver site locations.  The viewpoint of
1194        the  image  will  be  from the position of the transmitter
1195        site looking towards the location of  the  receiver.   The
1196        point-to-point path between the sites will be displayed as
1197        a white line while the RF line-of-sight path will be  dis-
1198        played  in  green.   G\bGo\boo\bog\bgl\ble\be E\bEa\bar\brt\bth\bh's navigation tools allow
1199        the user to "fly" around  the  path,  identify  landmarks,
1200        roads, and other featured content.
1201
1202        When performing regional coverage analysis, the  _\b._\bk_\bm_\bl file
1203        generated by  S\bSP\bPL\bLA\bAT\bT!\b!  will  permit  path  loss  or  signal
1204        strength  contours  to be layered on top of G\bGo\boo\bog\bgl\ble\be E\bEa\bar\brt\bth\bh's
1205        display in a semi-transparent manner.  The generated  _\b._\bk_\bm_\bl
1206        file  will have the same basename as that of the _\b._\bp_\bp_\bm file
1207        normally generated.
1208
1209 D\bDE\bET\bTE\bER\bRM\bMI\bIN\bNA\bAT\bTI\bIO\bON\bN O\bOF\bF A\bAN\bNT\bTE\bEN\bNN\bNA\bA H\bHE\bEI\bIG\bGH\bHT\bT A\bAB\bBO\bOV\bVE\bE A\bAV\bVE\bER\bRA\bAG\bGE\bE T\bTE\bER\bRR\bRA\bAI\bIN\bN
1210        S\bSP\bPL\bLA\bAT\bT!\b! determines antenna  height  above  average  terrain
1211        (HAAT)  according to the procedure defined by Federal Com-
1212        munications Commission Part 73.313(d).  According to  this
1213        definition, terrain elevations along eight radials between
1214        2 and 10 miles (3 and 16 kilometers) from the  site  being
1215        analyzed  are  sampled and averaged for each 45 degrees of
1216        azimuth starting with True North.  If one or more  radials
1217        lie  entirely  over  water or over land outside the United
1218        States (areas for which no USGS topography data is  avail-
1219        able), then those radials are omitted from the calculation
1220        of average terrain.
1221
1222        Note that SRTM elevation data, unlike older  3-arc  second
1223        USGS  data,  extends  beyond  the  borders  of  the United
1224        States.  Therefore, HAAT results may not be in  full  com-
1225        pliance with FCC Part 73.313(d) in areas along the borders
1226        of the United States if the SDF files used by  S\bSP\bPL\bLA\bAT\bT!\b!  are
1227        SRTM-derived.
1228
1229        When  performing  point-to-point  terrain analysis, S\bSP\bPL\bLA\bAT\bT!\b!
1230        determines the antenna height above average  terrain  only
1231        if  enough topographic data has already been loaded by the
1232        program to perform the point-to-point analysis.   In  most
1233        cases, this will be true, unless the site in question does
1234        not lie within 10 miles of the boundary of the  topography
1235        data in memory.
1236
1237        When  performing area prediction analysis, enough topogra-
1238        phy data is normally loaded by S\bSP\bPL\bLA\bAT\bT!\b! to  perform  average
1239        terrain  calculations.  Under such conditions, S\bSP\bPL\bLA\bAT\bT!\b! will
1240        provide the antenna height above average terrain  as  well
1241        as  the  average terrain above mean sea level for azimuths
1242        of 0, 45, 90, 135, 180, 225, 270,  and  315  degrees,  and
1243        include such information in the generated site report.  If
1244        one or more of the eight radials surveyed fall over water,
1245        or over regions for which no SDF data is available, S\bSP\bPL\bLA\bAT\bT!\b!
1246        reports _\bN_\bo _\bT_\be_\br_\br_\ba_\bi_\bn for the radial paths affected.
1247
1248 R\bRE\bES\bST\bTR\bRI\bIC\bCT\bTI\bIN\bNG\bG T\bTH\bHE\bE M\bMA\bAX\bXI\bIM\bMU\bUM\bM S\bSI\bIZ\bZE\bE O\bOF\bF A\bAN\bN A\bAN\bNA\bAL\bLY\bYS\bSI\bIS\bS R\bRE\bEG\bGI\bIO\bON\bN
1249        S\bSP\bPL\bLA\bAT\bT!\b! reads SDF files as needed into a series  of  memory
1250        "pages"  within the structure of the program.  Each "page"
1251        holds one SDF file representing a one degree by one degree
1252        region  of  terrain.   A _\b#_\bd_\be_\bf_\bi_\bn_\be _\bM_\bA_\bX_\bP_\bA_\bG_\bE_\bS statement in the
1253        first several lines of _\bs_\bp_\bl_\ba_\bt_\b._\bc_\bp_\bp sets the  maximum  number
1254        of "pages" available for holding topography data.  It also
1255        sets the maximum size of the topographic maps generated by
1256        S\bSP\bPL\bLA\bAT\bT!\b!.  MAXPAGES is set to 9 by default.  If S\bSP\bPL\bLA\bAT\bT!\b!  pro-
1257        duces a segmentation fault on start-up with this  default,
1258        it  is  an  indication  that not enough RAM and/or virtual
1259        memory (swap space) is available to run  S\bSP\bPL\bLA\bAT\bT!\b!  with  the
1260        number  of MAXPAGES specified.  In situations where avail-
1261        able memory is low, MAXPAGES may be reduced to 4 with  the
1262        understanding  that  this  will  greatly limit the maximum
1263        region S\bSP\bPL\bLA\bAT\bT!\b! will be able to analyze.  If  118  megabytes
1264        or  more  of  total memory (swap space plus RAM) is avail-
1265        able, then MAXPAGES may be increased  to  16.   This  will
1266        permit operation over a 4-degree by 4-degree region, which
1267        is sufficient for single  antenna  heights  in  excess  of
1268        10,000  feet  above mean sea level, or point-to-point dis-
1269        tances of over 1000 miles.
1270
1271 A\bAD\bDD\bDI\bIT\bTI\bIO\bON\bNA\bAL\bL I\bIN\bNF\bFO\bOR\bRM\bMA\bAT\bTI\bIO\bON\bN
1272        The latest news and information regarding S\bSP\bPL\bLA\bAT\bT!\b!  software
1273        is available through the official S\bSP\bPL\bLA\bAT\bT!\b! software web page
1274        located at: _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bq_\bs_\bl_\b._\bn_\be_\bt_\b/_\bk_\bd_\b2_\bb_\bd_\b/_\bs_\bp_\bl_\ba_\bt_\b._\bh_\bt_\bm_\bl.
1275
1276 A\bAU\bUT\bTH\bHO\bOR\bRS\bS
1277        John A. Magliacane, KD2BD <_\bk_\bd_\b2_\bb_\bd_\b@_\ba_\bm_\bs_\ba_\bt_\b._\bo_\br_\bg>
1278               Creator, Lead Developer
1279
1280        Doug McDonald <_\bm_\bc_\bd_\bo_\bn_\ba_\bl_\bd_\b@_\bs_\bc_\bs_\b._\bu_\bi_\bu_\bc_\b._\be_\bd_\bu>
1281               Original Longley-Rice Model integration
1282
1283        Ron Bentley <_\br_\bo_\bn_\bb_\be_\bn_\bt_\bl_\be_\by_\b@_\be_\ba_\br_\bt_\bh_\bl_\bi_\bn_\bk_\b._\bn_\be_\bt>
1284               Fresnel Zone plotting and clearance determination
1285
1286
1287
1288
1289 KD2BD Software          16 September 2007               SPLAT!(1)