1 SPLAT!(1) KD2BD Software SPLAT!(1)
6 splat - An RF S
\bSignal P
\bPropagation, L
\bLoss, A
\bAnd T
\bTerrain analy-
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]
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.
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
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.
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.
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
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:
78 --==[ SPLAT! v1.2.1 Available Options...
81 -t txsite(s).qth (max of 4 with -c, max of 30 with
84 -c plot coverage of TX(s) with an RX antenna at X
86 -L plot path loss map of TX based on an RX at X
88 -s filename(s) of city/site file(s) to import (5 max)
89 -b filename(s) of cartographic boundary file(s) to
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
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
101 -m earth radius multiplier
102 -n do not plot LOS paths in .ppm maps
103 -N do not produce unnecessary site or obstruction
105 -f frequency for Fresnel zone calculation (MHz)
106 -R modify default range for -c or -L (miles/kilome-
108 -db maximum loss contour to display on path loss maps
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
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
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.
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/.
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/
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/
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
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.
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.
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.
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).
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
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.
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):
232 15.000 ; Earth Dielectric Constant (Relative per-
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-
239 0 ; Polarization (0 = Horizontal, 1 = Verti-
241 0.50 ; Fraction of situations (50% of loca-
243 0.90 ; Fraction of time (90% of the time)
244 46000.0 ; ERP in Watts (optional)
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.
255 Typical Earth dielectric constants and conductivity values
258 Dielectric Constant Conductiv-
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
268 Poor ground : 4 0.001
270 Radio climate codes used by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! are as follows:
272 1: Equatorial (Congo)
273 2: Continental Subtropical (Sudan)
274 3: Maritime Subtropical (West coast of Africa)
276 5: Continental Temperate
277 6: Maritime Temperate, over land (UK and west
279 7: Maritime Temperate, over sea
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.
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.
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
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.
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
325 For example (_
\bc_
\bi_
\bt_
\bi_
\be_
\bs_
\b._
\bd_
\ba_
\bt):
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
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.
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
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.
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.
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.
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.
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:
392 splat -t tx_site.qth -r rx_site.qth
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:
409 splat -t tx_site.qth -r rx_site.qth -metric
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
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:
427 splat -t tx_site -r rx_site -d /cdrom/sdf/
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:
437 and can be generated using any text editor.
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:
443 splat -t tx_site -r rx_site -p terrain_profile.png
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.
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:
458 splat -t tx_site -r rx_site -e elevation_profile.png
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.
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:
479 splat -t tx_site -r rx_site -h height_profile.png
481 A terrain height plot normalized to the transmitter and
482 receiver antenna heights can be obtained using the _
\b-_
\bH
485 splat -t tx_site -r rx_site -H normalized_height_pro-
488 A contour of the Earth's curvature is also plotted in this
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:
496 splat -t tx_site -r rx_site -f 439.250 -H normal-
497 ized_height_profile.png
499 Fresnel Zone clearances other 60% can be specified using
500 the _
\b-_
\bf_
\bz switch as follows:
502 splat -t tx_site -r rx_site -f 439.250 -fz 75 -H
505 A graph showing Longley-Rice path loss may be plotted
506 using the _
\b-_
\bl switch:
508 splat -t tx_site -r rx_site -l path_loss_profile.png
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.
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.
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.
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:
533 _
\bS_
\bN_
\bR=_
\bT-_
\bN_
\bJ-_
\bL+_
\bG-_
\bN_
\bF
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.
542 T
\bT may be computed as follows:
544 _
\bT=_
\bT_
\bI+_
\bG_
\bT
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-
552 To compute how much more signal is available over the min-
553 imum to necessary to achieve a specific signal-to-noise
556 _
\bS_
\bi_
\bg_
\bn_
\ba_
\bl__
\bM_
\ba_
\br_
\bg_
\bi_
\bn=_
\bS_
\bN_
\bR-_
\bS
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).
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.
571 Topographic output is invoked using the _
\b-_
\bo switch:
573 splat -t tx_site -r rx_site -o topo_map.ppm
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.
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).
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:
591 splat -t tx_site -r rx_site -s cities.dat -o topo_map
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.
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:
600 splat -t tx_site -r rx_site -b co34_d00.dat -o topo_map
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
606 splat -t tx_site1 tx_site2 tx_site3 tx_site4 -r rx_site -p
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.
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:
630 convert splat_map.ppm splat_map.png
632 Another excellent PPM to PNG command-line utility is
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.
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:
642 splat -t tx_site -r rx_site -b co34_d00.dat -ngs -o
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:
649 convert -transparent "#FFFFFF" white_map.ppm transpar-
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:
662 splat -t tx_site -c 30.0 -s cities.dat -b co34_d00.dat -o
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.
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)
681 splat -t wnjt-dt -c 30.0 -m 1.333 -s cities.dat -b coun-
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.
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
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:
703 splat -t site1 site2 site3 site4 -c 10.0 -metric -o net-
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-
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)
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)
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)
731 site1 + site2 + site3 + site4: Gold2 (238,201,0)
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!.
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-
744 splat -t wnjt -L 30.0 -s cities.dat -b co34_d00.dat -o
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
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
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:
770 splat -t wnjt-dt -L 30.0 -s cities.dat -b co34_d00.dat -db
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.
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.
794 A path-loss color definition file possesses the following
795 structure (_
\bw_
\bn_
\bj_
\bt_
\b-_
\bd_
\bt_
\b._
\bl_
\bc_
\bf):
797 ; SPLAT! Auto-generated Path-Loss Color Definition
800 ; Format for the parameters held in this file is as fol-
803 ; dB: red, green, blue
805 ; ...where "dB" is the path loss (in dB) and
806 ; "red", "green", and "blue" are the corresponding RGB
808 ; definitions ranging from 0 to 255 for the region speci-
811 ; The following parameters may be edited and/or expanded
812 ; for future runs of SPLAT! A total of 32 contour
814 ; may be defined in this file.
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.
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):
847 ; SPLAT! Auto-generated Signal Color Definition ("wnjt-
850 ; Format for the parameters held in this file is as fol-
853 ; dBuV/m: red, green, blue
855 ; ...where "dBuV/m" is the signal strength (in dBuV/m)
857 ; "red", "green", and "blue" are the corresponding RGB
859 ; definitions ranging from 0 to 255 for the region speci-
862 ; The following parameters may be edited and/or expanded
863 ; for future runs of SPLAT! A total of 32 contour
865 ; may be defined in this file.
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.
891 Signal strength contours for some common VHF and UHF
892 broadcasting services in the United States are as follows:
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
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
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
926 FM Radio Broadcasting (88.1 - 107.9 MHz)
927 ----------------------------------------
928 Analog Service Contour: 60 dBuV/m
929 Digital Service Contour: 65 dBuV/m
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.
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):
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.
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-
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.
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):
998 In this example, the antenna is mechanically tilted down-
999 ward 1.1 degrees towards an azimuth of 130.0 degrees.
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
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-
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.
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:
1030 splat -t kvea -L 30.0 -R 50.0 -db 140 -plo pathloss.dat
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):
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
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.
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.
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.)
1092 Modified path loss maps can be imported back into S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!
1093 for generating revised coverage maps:
1095 splat -t kvea -pli pathloss.dat -s city.dat -b county.dat
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!.
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:
1110 splat -t tx_site -r rx_site -udt udt_file.txt -o map.ppm
1112 A user-defined terrain file has the following appearance
1115 40.32180556, 74.1325, 100.0 meters
1116 40.321805, 74.1315, 300.0
1117 40.3218055, 74.1305, 100.0 meters
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!.
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-
1140 splat -t tx_site -r rx_site -n -o topo_map.ppm
1142 If no text report is desired, then the _
\b-_
\bN switch is used:
1144 splat -t tx_site -r rx_site -N -o topo_map.ppm
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:
1150 splat -t tx_site -R 50.0 -s NJ_Cities -b NJ_Counties -o
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.
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.
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
1171 splat -t kd2bd -R 50.0 -s NJ_Cities -b NJ_Counties -geo -o
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.
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:
1184 splat -t wnjt-dt -r kd2bd -kml
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
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.
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
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
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
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
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.
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.
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.
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
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
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
1289 KD2BD Software 16 September 2007 SPLAT!(1)