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_
\b__
\ba_
\bn_
\bt_
\be_
\bn_
\bn_
\ba_
\b__
\bh_
\be_
\bi_
\bg_
\bh_
\bt_
\b__
\bf_
\bo_
\br_
\b__
\bl_
\bo_
\bs_
\b__
\bc_
\bo_
\bv_
\be_
\br_
\ba_
\bg_
\be_
\b__
\ba_
\bn_
\ba_
\bl_
\by_
\bs_
\bi_
\bs _
\b(_
\bf_
\be_
\be_
\bt_
\b)
12 _
\b(_
\bf_
\bl_
\bo_
\ba_
\bt_
\b)] [-L _
\br_
\bx_
\b__
\ba_
\bn_
\bt_
\be_
\bn_
\bn_
\ba_
\b__
\bh_
\be_
\bi_
\bg_
\bh_
\bt_
\b__
\bf_
\bo_
\br_
\b__
\bL_
\bo_
\bn_
\bg_
\bl_
\be_
\by_
\b-_
\bR_
\bi_
\bc_
\be_
\b__
\bc_
\bo_
\bv_
\be_
\br_
\b-
13 _
\ba_
\bg_
\be_
\b__
\ba_
\bn_
\ba_
\bl_
\by_
\bs_
\bi_
\bs _
\b(_
\bf_
\be_
\be_
\bt_
\b) _
\b(_
\bf_
\bl_
\bo_
\ba_
\bt_
\b)] [-p _
\bt_
\be_
\br_
\br_
\ba_
\bi_
\bn_
\b__
\bp_
\br_
\bo_
\bf_
\bi_
\bl_
\be_
\b._
\be_
\bx_
\bt] [-e
14 _
\be_
\bl_
\be_
\bv_
\ba_
\bt_
\bi_
\bo_
\bn_
\b__
\bp_
\br_
\bo_
\bf_
\bi_
\bl_
\be_
\b._
\be_
\bx_
\bt] [-h _
\bh_
\be_
\bi_
\bg_
\bh_
\bt_
\b__
\bp_
\br_
\bo_
\bf_
\bi_
\bl_
\be_
\b._
\be_
\bx_
\bt] [-l _
\bL_
\bo_
\bn_
\bg_
\b-
15 _
\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_
\bn_
\ba_
\bm_
\be_
\b._
\bp_
\bp_
\bm]
16 [-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
17 _
\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
18 _
\be_
\ba_
\br_
\bt_
\bh_
\b__
\br_
\ba_
\bd_
\bi_
\bu_
\bs_
\b__
\bm_
\bu_
\bl_
\bt_
\bi_
\bp_
\bl_
\bi_
\be_
\br _
\b(_
\bf_
\bl_
\bo_
\ba_
\bt_
\b)] [-R _
\bm_
\ba_
\bx_
\bi_
\bm_
\bu_
\bm_
\b__
\bc_
\bo_
\bv_
\be_
\br_
\b-
19 _
\ba_
\bg_
\be_
\b__
\br_
\ba_
\bn_
\bg_
\be _
\b(_
\bf_
\bo_
\br _
\b-_
\bc _
\bo_
\br _
\b-_
\bL_
\b) _
\b(_
\bm_
\bi_
\bl_
\be_
\bs_
\b) _
\b(_
\bf_
\bl_
\bo_
\ba_
\bt_
\b)] [-dB _
\bm_
\ba_
\bx_
\bi_
\bm_
\bu_
\bm
20 _
\ba_
\bt_
\bt_
\be_
\bn_
\bu_
\ba_
\bt_
\bi_
\bo_
\bn _
\bc_
\bo_
\bn_
\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
21 _
\bd_
\bB_
\b)] [-n] [-N]
23 D
\bDE
\bES
\bSC
\bCR
\bRI
\bIP
\bPT
\bTI
\bIO
\bON
\bN
24 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! is a powerful terrestrial RF propagation and ter-
25 rain analysis tool covering the spectrum between 20 MHz
26 and 20 GHz. It is designed for operation on Unix and
27 Linux-based workstations. S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! is free software.
28 Redistribution and/or modification is permitted under the
29 terms of the GNU General Public License as published by
30 the Free Software Foundation, either version 2 of the
31 License or any later version. Adoption of S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! source
32 code in proprietary or closed-source applications is a
33 violation of this license, and is s
\bst
\btr
\bri
\bic
\bct
\btl
\bly
\by forbidden.
35 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! is distributed in the hope that it will be useful,
36 but WITHOUT ANY WARRANTY, without even the implied war-
37 ranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
38 POSE. See the GNU General Public License for more details.
40 I
\bIN
\bNT
\bTR
\bRO
\bOD
\bDU
\bUC
\bCT
\bTI
\bIO
\bON
\bN
41 Applications of S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! include the visualization, design,
42 and link budget analysis of wireless Wide Area Networks
43 (WANs), commercial and amateur radio communication systems
44 above 20 MHz, microwave links, frequency coordination, and
45 the determination of analog and digital terrestrial radio
46 and television contour regions.
48 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! provides RF site engineering data such as great
49 circle distances and bearings between sites, antenna ele-
50 vation angles (uptilt), depression angles (downtilt),
51 antenna height above mean sea level, antenna height above
52 average terrain, bearings and distances to known obstruc-
53 tions, Longley-Rice path attenuation, and minimum antenna
54 height requirements needed to establish line-of-sight com-
55 munication paths absent of obstructions due to terrain.
56 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! produces reports, graphs, and highly detailed and
57 carefully annotated topographic maps depicting line-of-
58 sight paths, path loss, and expected coverage areas of
59 transmitters and repeater systems. When performing line-
60 of-sight analysis in situations where multiple transmitter
61 or repeater sites are employed, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! determines individ-
62 ual and mutual areas of coverage within the network speci-
65 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
66 _
\bm_
\bo_
\bd_
\be, and _
\ba_
\br_
\be_
\ba _
\bp_
\br_
\be_
\bd_
\bi_
\bc_
\bt_
\bi_
\bo_
\bn _
\bm_
\bo_
\bd_
\be, and may be invoked using
67 either line-of-sight (LOS) or Irregular Terrain (ITM)
68 propagation models. True Earth, four-thirds Earth, or any
69 other Earth radius may be specified by the user when per-
70 forming line-of-sight analysis.
72 I
\bIN
\bNP
\bPU
\bUT
\bT F
\bFI
\bIL
\bLE
\bES
\bS
73 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! is a command-line driven application, and reads
74 input data through a number of data files. Some files are
75 mandatory for successful execution of the program, while
76 others are optional. Mandatory files include SPLAT Data
77 Files (SDF files), site location files (QTH files), and
78 Longley-Rice model parameter files (LRP files). Optional
79 files include city/site location files, and cartographic
82 S
\bSP
\bPL
\bLA
\bAT
\bT D
\bDA
\bAT
\bTA
\bA F
\bFI
\bIL
\bLE
\bES
\bS
83 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! imports topographic data in the form of SPLAT Data
84 Files (SDFs). These files may be generated from a number
85 of information sources. In the United States, SPLAT Data
86 Files can be generated through U.S. Geological Survey
87 Digital Elevation Models (DEMs) using the u
\bus
\bsg
\bgs
\bs2
\b2s
\bsd
\bdf
\bf utility
88 included with S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!. USGS Digital Elevation Models com-
89 patible with this utility may be downloaded from:
90 _
\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/.
92 Significantly better resolution can be obtained through
93 the use of SRTM-3 Version 2 digital elevation models.
94 These models are the result of the STS-99 Space Shuttle
95 Radar Topography Mission, and are available for most popu-
96 lated regions of the Earth. SPLAT Data Files may be gen-
97 erated from SRTM data using the included s
\bsr
\brt
\btm
\bm2
\b2s
\bsd
\bdf
\bf utility.
98 SRTM-3 Version 2 data may be obtained through anonymous
99 FTP from: _
\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/
101 Despite the higher accuracy that SRTM data has to offer,
102 some voids in the data sets exist. When voids are
103 detected, the s
\bsr
\brt
\btm
\bm2
\b2s
\bsd
\bdf
\bf utility replaces them with corre-
104 sponding data found in existing SDF files (that were pre-
105 sumably created from earlier USGS data through the
106 u
\bus
\bsg
\bgs
\bs2
\b2s
\bsd
\bdf
\bf utility). If USGS-derived SDF data is not avail-
107 able, voids are handled through adjacent pixel averaging,
108 or direct replacement.
110 SPLAT Data Files contain integer value topographic eleva-
111 tions (in meters) referenced to mean sea level for
112 1-degree by 1-degree regions of the earth with a resolu-
113 tion of 3-arc seconds. SDF files can be read in either
114 standard format (_
\b._
\bs_
\bd_
\bf) as generated by the u
\bus
\bsg
\bgs
\bs2
\b2s
\bsd
\bdf
\bf and
115 s
\bsr
\brt
\btm
\bm2
\b2s
\bsd
\bdf
\bf utilities, or in bzip2 compressed format
116 (_
\b._
\bs_
\bd_
\bf_
\b._
\bb_
\bz_
\b2). Since uncompressed files can be processed
117 slightly faster than files that have been compressed,
118 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! searches for the needed SDF data in uncompressed
119 format first. If uncompressed data cannot located, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!
120 then searches for data in bzip2 compressed format. If no
121 compressed SDF files can be found for the region
122 requested, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! assumes the region is over water, and
123 will assign an elevation of sea-level to these areas.
125 This feature of S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! makes it possible to perform path
126 analysis not only over land, but also between coastal
127 areas not represented by Digital Elevation Model data.
128 This behavior of S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! underscores the importance of hav-
129 ing all the SDF files required for the region being ana-
130 lyzed if meaningful results are to be expected.
132 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
133 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! imports site location information of transmitter
134 and receiver sites analyzed by the program from ASCII
135 files having a _
\b._
\bq_
\bt_
\bh extension. QTH files contain the
136 site's name, the site's latitude (positive if North of the
137 equator, negative if South), the site's longitude (in
138 degrees West, 0 to 360 degrees), and the site's antenna
139 height above ground level (AGL). A single line-feed char-
140 acter separates each field. The antenna height is assumed
141 to be specified in feet unless followed by the letter _
\bm or
142 the word _
\bm_
\be_
\bt_
\be_
\br_
\bs in either upper or lower case. Latitude
143 and longitude information may be expressed in either deci-
144 mal format (74.6889) or degree, minute, second (DMS) for-
147 For example, a site location file describing television
148 station WNJT, Trenton, NJ (_
\bw_
\bn_
\bj_
\bt_
\b._
\bq_
\bt_
\bh) might read as fol-
156 Each transmitter and receiver site analyzed by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! must
157 be represented by its own site location (QTH) file.
159 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
160 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! imports Longley-Rice model parameter data from
161 files having the same base name as the transmitter site
162 QTH file, but with a _
\b._
\bl_
\br_
\bp extension, thus providing simple
163 and accurate correlation between these associated data
164 sets. The format for the Longley-Rice model parameter
165 files is as follows (_
\bw_
\bn_
\bj_
\bt_
\b._
\bl_
\br_
\bp):
167 15.000 ; Earth Dielectric Constant (Relative per-
169 0.005 ; Earth Conductivity (Siemens per meter)
170 301.000 ; Atmospheric Bending Constant (N-units)
171 700.000 ; Frequency in MHz (20 MHz to 20 GHz)
172 5 ; Radio Climate (5 = Continental Temper-
174 0 ; Polarization (0 = Horizontal, 1 = Verti-
176 0.5 ; Fraction of situations (50% of loca-
178 0.5 ; Fraction of time (50% of the time)
180 If an LRP file corresponding to the tx_site QTH file can-
181 not be found, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! scans the current working directory
182 for the file "splat.lrp". If this file cannot be found,
183 then the default parameters listed above will be assigned
184 by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! and a corresponding "splat.lrp" file containing
185 this data will be written to the current working direc-
186 tory. "splat.lrp" can then be edited by the user as
189 Typical Earth dielectric constants and conductivity values
192 Dielectric Constant Conductiv-
194 Salt water : 80 5.000
195 Good ground : 25 0.020
196 Fresh water : 80 0.010
197 Marshy land : 12 0.007
198 Farmland, forest : 15 0.005
199 Average ground : 15 0.005
200 Mountain, sand : 13 0.002
202 Poor ground : 4 0.001
204 Radio climate codes used by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! are as follows:
206 1: Equatorial (Congo)
207 2: Continental Subtropical (Sudan)
208 3: Maritime Subtropical (West coast of Africa)
210 5: Continental Temperate
211 6: Maritime Temperate, over land (UK and west
213 7: Maritime Temperate, over sea
215 The Continental Temperate climate is common to large land
216 masses in the temperate zone, such as the United States.
217 For paths shorter than 100 km, there is little difference
218 between Continental and Maritime Temperate climates.
220 The final two parameters in the _
\b._
\bl_
\br_
\bp file correspond to
221 the statistical analysis provided by the Longley-Rice
222 model. In this example, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! will return the maximum
223 path loss occurring 50% of the time (fraction of time) in
224 50% of situations (fraction of situations). Use a frac-
225 tion of time parameter of 0.97 for digital television,
226 0.50 for analog in the United States. Isotropic antennas
229 For further information on these parameters, see:
230 _
\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
231 _
\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-
232 _
\bl_
\be_
\by_
\b__
\br_
\bi_
\bc_
\be_
\b._
\bh_
\bt_
\bm_
\bl
234 C
\bCI
\bIT
\bTY
\bY L
\bLO
\bOC
\bCA
\bAT
\bTI
\bIO
\bON
\bN F
\bFI
\bIL
\bLE
\bES
\bS
235 The names and locations of cities, tower sites, or other
236 points of interest may be imported and plotted on topo-
237 graphic maps generated by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!. S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! imports the
238 names of cities and locations from ASCII files containing
239 the location's name, the location's latitude, and the
240 location's longitude. Each field is separated by a comma.
241 Each record is separated by a single line feed character.
242 As was the case with the _
\b._
\bq_
\bt_
\bh files, latitude and longi-
243 tude information may be entered in either decimal or
244 degree, minute, second (DMS) format.
246 For example (_
\bc_
\bi_
\bt_
\bi_
\be_
\bs_
\b._
\bd_
\ba_
\bt):
248 Teaneck, 40.891973, 74.014506
249 Tenafly, 40.919212, 73.955892
250 Teterboro, 40.859511, 74.058908
251 Tinton Falls, 40.279966, 74.093924
252 Toms River, 39.977777, 74.183580
253 Totowa, 40.906160, 74.223310
254 Trenton, 40.219922, 74.754665
256 A total of five separate city data files may be imported
257 at a time, and there is no limit to the size of these
258 files. S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! reads city data on a "first come/first
259 served" basis, and plots only those locations whose anno-
260 tations do not conflict with annotations of locations
261 plotted earlier during S
\bSP
\bPL
\bLA
\bAT
\bT's execution. This behavior
262 minimizes clutter in S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! generated topographic maps,
263 but also mandates that important locations be placed
264 toward the beginning of the first city data file, and
265 disposable locations be positioned further down the list
266 or in subsequent data files.
268 City data files may be generated manually using any text
269 editor, imported from other sources, or derived from data
270 available from the U.S. Census Bureau using the c
\bci
\bit
\bty
\byd
\bde
\be-
\b-
271 c
\bco
\bod
\bde
\ber
\br utility included with S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!. Such data is avail-
272 able free of charge via the Internet at: _
\bh_
\bt_
\bt_
\bp_
\b:_
\b/_
\b/_
\bw_
\bw_
\bw_
\b._
\bc_
\be_
\bn_
\b-
273 _
\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
276 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
277 Cartographic boundary data may also be imported to plot
278 the boundaries of cities, counties, or states on topo-
279 graphic maps generated by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!. Such data must be of
280 the form of ARC/INFO Ungenerate (ASCII Format) Metadata
281 Cartographic Boundary Files, and are available from the
282 U.S. Census Bureau via the Internet at: _
\bh_
\bt_
\bt_
\bp_
\b:_
\b/_
\b/_
\bw_
\bw_
\bw_
\b._
\bc_
\be_
\bn_
\b-
283 _
\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-
284 _
\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
285 separate cartographic boundary files may be imported at a
286 time. It is not necessary to import state boundaries if
287 county boundaries have already been imported.
289 P
\bPR
\bRO
\bOG
\bGR
\bRA
\bAM
\bM O
\bOP
\bPE
\bER
\bRA
\bAT
\bTI
\bIO
\bON
\bN
290 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! is invoked via the command-line using a series of
291 switches and arguments. Since S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! is a CPU and memory
292 intensive application, this type of interface minimizes
293 overhead and lends itself well to scripted (batch) opera-
294 tions. S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!'s CPU and memory scheduling priority may be
295 modified through the use of the Unix n
\bni
\bic
\bce
\be command.
297 The number and type of switches passed to S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! determine
298 its mode of operation and method of output data genera-
299 tion. Nearly all of S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!'s switches may be cascaded in
300 any order on the command line when invoking the program.
302 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
303 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! may be used to perform line-of-sight terrain analy-
304 sis between two specified site locations. For example:
306 splat -t tx_site.qth -r rx_site.qth
308 invokes a terrain analysis between the transmitter speci-
309 fied in _
\bt_
\bx_
\b__
\bs_
\bi_
\bt_
\be_
\b._
\bq_
\bt_
\bh and receiver specified in _
\br_
\bx_
\b__
\bs_
\bi_
\bt_
\be_
\b._
\bq_
\bt_
\bh,
310 and writes a S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! Obstruction Report to the current
311 working directory. The report contains details of the
312 transmitter and receiver sites, and identifies the loca-
313 tion of any obstructions detected during the analysis. If
314 an obstruction can be cleared by raising the receive
315 antenna to a greater altitude, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! will indicate the
316 minimum antenna height required for a line-of-sight path
317 to exist between the transmitter and receiver locations
318 specified. If the antenna must be raised a significant
319 amount, this determination may take some time. Note that
320 the results provided are the _
\bm_
\bi_
\bn_
\bi_
\bm_
\bu_
\bm necessary for a line-
321 of-sight path to exist, and do not take Fresnel zone
322 clearance requirements into consideration.
324 _
\bq_
\bt_
\bh extensions are assumed by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! for QTH files, and
325 are optional when invoking the program. S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! automati-
326 cally reads all SPLAT Data Files necessary to conduct the
327 terrain analysis between the sites specified. S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!
328 searches for the needed SDF files in the current working
329 directory first. If the needed files are not found,
330 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! then searches in the path specified by the _
\b-_
\bd
333 splat -t tx_site -r rx_site -d /cdrom/sdf/
335 An external directory path may be specified by placing a
336 ".splat_path" file under the user's home directory. This
337 file must contain the full directory path to the last
338 resort location of all the SDF files. The path in the
339 _
\b$_
\bH_
\bO_
\bM_
\bE_
\b/_
\b._
\bs_
\bp_
\bl_
\ba_
\bt_
\b__
\bp_
\ba_
\bt_
\bh file must be of the form of a single
344 and can be generated using any text editor.
346 A graph of the terrain profile between the receiver and
347 transmitter locations as a function of distance from the
348 receiver can be generated by adding the _
\b-_
\bp switch:
350 splat -t tx_site -r rx_site -p terrain_profile.gif
352 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! invokes g
\bgn
\bnu
\bup
\bpl
\blo
\bot
\bt when generating graphs. The file-
353 name extension specified to S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! determines the format
354 of the graph produced. _
\b._
\bg_
\bi_
\bf will produce a 640x480 color
355 GIF graphic file, while _
\b._
\bp_
\bs or _
\b._
\bp_
\bo_
\bs_
\bt_
\bs_
\bc_
\br_
\bi_
\bp_
\bt will produce
356 postscript output. Output in formats such as PNG, Adobe
357 Illustrator, AutoCAD dxf, LaTeX, and many others are
358 available. Please consult g
\bgn
\bnu
\bup
\bpl
\blo
\bot
\bt, and g
\bgn
\bnu
\bup
\bpl
\blo
\bot
\bt's documen-
359 tation for details on all the supported output formats.
361 A graph of elevations subtended by the terrain between the
362 receiver and transmitter as a function of distance from
363 the receiver can be generated by using the _
\b-_
\be switch:
365 splat -t tx_site -r rx_site -e elevation_profile.gif
367 The graph produced using this switch illustrates the ele-
368 vation and depression angles resulting from the terrain
369 between the receiver's location and the transmitter site
370 from the perspective of the receiver's location. A second
371 trace is plotted between the left side of the graph
372 (receiver's location) and the location of the transmitting
373 antenna on the right. This trace illustrates the eleva-
374 tion angle required for a line-of-sight path to exist
375 between the receiver and transmitter locations. If the
376 trace intersects the elevation profile at any point on the
377 graph, then this is an indication that a line-of-sight
378 path does not exist under the conditions given, and the
379 obstructions can be clearly identified on the graph at the
380 point(s) of intersection.
382 A graph illustrating terrain height referenced to a line-
383 of-sight path between the transmitter and receiver may be
384 generated using the _
\b-_
\bh switch:
386 splat -t tx_site -r rx_site -h height_profile.gif
388 The Earth's curvature is clearly evident when plotting
391 A graph showing Longley-Rice path loss may be plotted
392 using the _
\b-_
\bl switch:
394 splat -t tx_site -r rx_site -l path_loss_profile.gif
396 When performing path loss profiles, a Longley-Rice Model
397 Path Loss Report is generated by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! in the form of a
398 text file with a _
\b._
\bl_
\br_
\bo filename extension. The report con-
399 tains bearings and distances between the transmitter and
400 receiver, as well as the Longley-Rice path loss for vari-
401 ous distances between the transmitter and receiver loca-
402 tions. The mode of propagation for points along the path
403 are 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 _
\bH_
\bo_
\br_
\bi_
\b-
404 _
\bz_
\bo_
\bn, _
\bD_
\bi_
\bf_
\bf_
\br_
\ba_
\bc_
\bt_
\bi_
\bo_
\bn _
\bD_
\bo_
\bm_
\bi_
\bn_
\ba_
\bn_
\bt, and _
\bT_
\br_
\bo_
\bp_
\bo_
\bs_
\bc_
\ba_
\bt_
\bt_
\be_
\br _
\bD_
\bo_
\bm_
\bi_
\bn_
\ba_
\bn_
\bt.
406 To determine the signal-to-noise (SNR) ratio at remote
407 location where random Johnson (thermal) noise is the pri-
408 mary limiting factor in reception:
410 _
\bS_
\bN_
\bR=_
\bT-_
\bN_
\bJ-_
\bL+_
\bG-_
\bN_
\bF
412 where T
\bT is the ERP of the transmitter in dBW, N
\bNJ
\bJ is John-
413 son Noise in dBW (-136 dBW for a 6 MHz TV channel), L
\bL is
414 the path loss provided by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! in dB (as a _
\bp_
\bo_
\bs_
\bi_
\bt_
\bi_
\bv_
\be num-
415 ber), G
\bG is the receive antenna gain in dB over isotropic,
416 and N
\bNF
\bF is the receiver noise figure in dB.
418 T
\bT may be computed as follows:
420 _
\bT=_
\bT_
\bI+_
\bG_
\bT
422 where T
\bTI
\bI is actual amount of RF power delivered to the
423 transmitting antenna in dBW, G
\bGT
\bT is the transmitting
424 antenna gain (over isotropic) in the direction of the
425 receiver (or the horizon if the receiver is over the hori-
428 To compute how much more signal is available over the min-
429 imum to necessary to achieve a specific signal-to-noise
432 _
\bS_
\bi_
\bg_
\bn_
\ba_
\bl__
\bM_
\ba_
\br_
\bg_
\bi_
\bn=_
\bS_
\bN_
\bR-_
\bS
434 where S
\bS is the minimum desired SNR ratio (15.5 dB for ATSC
435 DTV, 42 dB for analog NTSC television).
437 A topographic map may be generated by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! to visualize
438 the path between the transmitter and receiver sites from
439 yet another perspective. Topographic maps generated by
440 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! display elevations using a logarithmic grayscale,
441 with higher elevations represented through brighter shades
442 of gray. The dynamic range of the image is scaled between
443 the highest and lowest elevations present in the map. The
444 only exception to this is sea-level, which is represented
445 using the color blue.
447 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! generated topographic maps are 24-bit TrueColor
448 Portable PixMap (PPM) images. They may be viewed, edited,
449 or converted to other graphic formats by popular image
450 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,
451 and X
\bXP
\bPa
\bai
\bin
\bnt
\bt. PNG format is highly recommended for lossless
452 compressed storage of S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! generated topographic output
453 files. An excellent command-line utility capable of con-
454 verting S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! PPM graphic files to PNG files is w
\bwp
\bpn
\bng
\bg, and
456 _
\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
457 last resort, PPM files may be compressed using the bzip2
458 utility, and read directly by T
\bTh
\bhe
\be G
\bGI
\bIM
\bMP
\bP in this format.
459 Topographic output is specified using the _
\b-_
\bo switch:
461 splat -t tx_site -r rx_site -o topo_map.ppm
463 The _
\b._
\bp_
\bp_
\bm extension on the output filename is assumed by
464 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!, and is optional.
466 In this example, _
\bt_
\bo_
\bp_
\bo_
\b__
\bm_
\ba_
\bp_
\b._
\bp_
\bp_
\bm will illustrate the loca-
467 tions of the transmitter and receiver sites specified. In
468 addition, the great circle path between the two sites will
469 be drawn over locations for which an unobstructed path
470 exists to the transmitter at a receiving antenna height
471 equal to that of the receiver site (specified in
472 _
\br_
\bx_
\b__
\bs_
\bi_
\bt_
\be_
\b._
\bq_
\bt_
\bh).
474 It may desirable to populate the topographic map with
475 names and locations of cities, tower sites, or other
476 important locations. A city file may be passed to S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!
477 using the _
\b-_
\bs switch:
479 splat -t tx_site -r rx_site -s cities.dat -o topo_map
481 Up to five separate city files may be passed to S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! at
482 a time following the _
\b-_
\bs switch.
484 County and state boundaries may be added to the map by
485 specifying up to five U.S. Census Bureau cartographic
486 boundary files using the _
\b-_
\bb switch:
488 splat -t tx_site -r rx_site -b co34_d00.dat -o topo_map
490 In situations where multiple transmitter sites are in use,
491 as many as four site locations may be passed to S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! at
494 splat -t tx_site1 tx_site2 tx_site3 tx_site4 -r rx_site -p
497 In this example, four separate terrain profiles and
498 obstruction reports will be generated by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!. A single
499 topographic map can be specified using the _
\b-_
\bo switch, and
500 line-of-sight paths between each transmitter and the
501 receiver site indicated will be produced on the map, each
502 in its own color. The path between the first transmitter
503 specified to the receiver will be in green, the path
504 between the second transmitter and the receiver will be in
505 cyan, the path between the third transmitter and the
506 receiver will be in violet, and the path between the
507 fourth transmitter and the receiver will be in sienna.
509 D
\bDE
\bET
\bTE
\bER
\bRM
\bMI
\bIN
\bNI
\bIN
\bNG
\bG R
\bRE
\bEG
\bGI
\bIO
\bON
\bNA
\bAL
\bL C
\bCO
\bOV
\bVE
\bER
\bRA
\bAG
\bGE
\bE
510 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! can analyze a transmitter or repeater site, or net-
511 work of sites, and predict the regional coverage for each
512 site specified. In this mode, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! can generate a topo-
513 graphic map displaying the geometric line-of-sight cover-
514 age area of the sites based on the location of each site
515 and the height of receive antenna wishing to communicate
516 with the site in question. S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! switches from point-to-
517 point analysis mode to area prediction mode when the _
\b-_
\bc
518 switch is invoked as follows:
520 splat -t tx_site -c 30.0 -s cities.dat -b co34_d00.dat -o
523 In this example, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! generates a topographic map called
524 _
\bt_
\bx_
\b__
\bc_
\bo_
\bv_
\be_
\br_
\ba_
\bg_
\be_
\b._
\bp_
\bp_
\bm that illustrates the predicted line-of-
525 sight regional coverage of _
\bt_
\bx_
\b__
\bs_
\bi_
\bt_
\be to receiving locations
526 having antennas 30.0 feet above ground level (AGL). The
527 contents of _
\bc_
\bi_
\bt_
\bi_
\be_
\bs_
\b._
\bd_
\ba_
\bt are plotted on the map, as are the
528 cartographic boundaries contained in the file
529 _
\bc_
\bo_
\b3_
\b4_
\b__
\bd_
\b0_
\b0_
\b._
\bd_
\ba_
\bt.
531 When plotting line-of-sight paths and areas of regional
532 coverage, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! by default does not account for the
533 effects of atmospheric bending. However, this behavior
534 may be modified by using the Earth radius multiplier (_
\b-_
\bm)
537 splat -t wnjt -c 30.0 -m 1.333 -s cities.dat -b coun-
540 An earth radius multiplier of 1.333 instructs S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! to
541 use the "four-thirds earth" model for line-of-sight propa-
542 gation analysis. Any appropriate earth radius multiplier
543 may be selected by the user.
545 When invoked in area prediction mode, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! generates a
546 site report for each station analyzed. S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! site
547 reports contain details of the site's geographic location,
548 its height above mean sea level, the antenna's height
549 above mean sea level, the antenna's height above average
550 terrain, and the height of the average terrain calculated
551 in the directions of 0, 45, 90, 135, 180, 225, 270, and
554 If the _
\b-_
\bc switch is replaced by a _
\b-_
\bL switch, a Longley-
555 Rice path loss map for a transmitter site may be gener-
558 splat -t wnjt -L 30.0 -s cities.dat -b co34_d00.dat -o
561 In this mode, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! generates a multi-color map illus-
562 trating expected signal levels (path loss) in areas sur-
563 rounding the transmitter site. A legend at the bottom of
564 the map correlates each color with a specific path loss
565 level in decibels. Since Longley-Rice area prediction map
566 generation is very CPU intensive, provision for limiting
567 the analysis range is provided by the _
\b-_
\bR switch. The
568 argument must be given in miles. If a range wider than
569 the generated topographic map is specified, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! will
570 perform Longley-Rice path loss calculations between all
571 four corners of the area prediction map.
573 The _
\b-_
\bd_
\bb switch allows a constraint to be placed on the
574 maximum path loss region plotted on the map. A path loss
575 between 80 and 230 dB may be specified using this switch.
576 For example, if a path loss beyond -140 dB is irrelevant
577 to the survey being conducted, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!'s path loss plot can
578 be constrained to the region bounded by the 140 dB attenu-
579 ation contour as follows:
581 splat -t wnjt -L 30.0 -s cities.dat -b co34_d00.dat -db
585 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 C
\bCO
\bOV
\bVE
\bER
\bRA
\bAG
\bGE
\bE
586 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! can also display line-of-sight coverage areas for
587 as many as four separate transmitter sites on a common
588 topographic map. For example:
590 splat -t site1 site2 site3 site4 -c 30.0 -o network.ppm
592 plots the regional line-of-sight coverage of site1, site2,
593 site3, and site4 based on a receive antenna located 30.0
594 feet above ground level. A topographic map is then
595 written to the file _
\bn_
\be_
\bt_
\bw_
\bo_
\br_
\bk_
\b._
\bp_
\bp_
\bm. The line-of-sight cover-
596 age area of the transmitters are plotted as follows in the
597 colors indicated (along with their corresponding RGB val-
600 site1: Green (0,255,0)
601 site2: Cyan (0,255,255)
602 site3: Medium Violet (147,112,219)
603 site4: Sienna 1 (255,130,71)
605 site1 + site2: Yellow (255,255,0)
606 site1 + site3: Pink (255,192,203)
607 site1 + site4: Green Yellow (173,255,47)
608 site2 + site3: Orange (255,165,0)
609 site2 + site4: Dark Sea Green 1 (193,255,193)
610 site3 + site4: Dark Turquoise (0,206,209)
612 site1 + site2 + site3: Dark Green (0,100,0)
613 site1 + site2 + site4: Blanched Almond (255,235,205)
614 site1 + site3 + site4: Medium Spring Green (0,250,154)
615 site2 + site3 + site4: Tan (210,180,140)
617 site1 + site2 + site3 + site4: Gold2 (238,201,0)
619 If separate _
\b._
\bq_
\bt_
\bh files are generated, each representing a
620 common site location but a different antenna height, a
621 single topographic map illustrating the regional coverage
622 from as many as four separate locations on a single tower
623 may be generated by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!.
625 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
626 In certain situations, it may be desirable to generate a
627 topographic map of a region without plotting coverage
628 areas, line-of-sight paths, or generating obstruction
629 reports. There are several ways of doing this. If one
630 wishes to generate a topographic map illustrating the
631 location of a transmitter and receiver site along with a
632 brief text report describing the locations and distances
633 between the sites, the _
\b-_
\bn switch should be invoked as fol-
636 splat -t tx_site -r rx_site -n -o topo_map.ppm
638 If no text report is desired, then the _
\b-_
\bN switch is used:
640 splat -t tx_site -r rx_site -N -o topo_map.ppm
642 If the _
\b-_
\bo switch and output filename are omitted when
643 using either the _
\b-_
\bn or _
\b-_
\bN switches, output is written to a
644 file named _
\bm_
\ba_
\bp_
\b._
\bp_
\bp_
\bm in the current working directory by
647 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
648 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! determines antenna height above average terrain
649 (HAAT) according to the procedure defined by Federal Com-
650 munications Commission Part 73.313(d). According to this
651 definition, terrain elevations along eight radials between
652 2 and 10 miles (3 and 16 kilometers) from the site being
653 analyzed are sampled and averaged for each 45 degrees of
654 azimuth starting with True North. If one or more radials
655 lie entirely over water or over land outside the United
656 States (areas for which no USGS topography data is avail-
657 able), then those radials are omitted from the calculation
658 of average terrain. If part of a radial extends over a
659 body of water or over land outside the United States, then
660 only that part of the radial lying over United States land
661 is used in the determination of average terrain.
663 Note that SRTM elevation data, unlike older 3-arc second
664 USGS data, extends beyond the borders of the United
665 States. Therefore, HAAT results may not be in full com-
666 pliance with FCC Part 73.313(d) in areas along the borders
667 of the United States if the SDF files used by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! are
670 When performing point-to-point terrain analysis, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!
671 determines the antenna height above average terrain only
672 if enough topographic data has already been loaded by the
673 program to perform the point-to-point analysis. In most
674 cases, this will be true, unless the site in question does
675 not lie within 10 miles of the boundary of the topography
678 When performing area prediction analysis, enough topogra-
679 phy data is normally loaded by S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! to perform average
680 terrain calculations. Under such conditions, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! will
681 provide the antenna height above average terrain as well
682 as the average terrain above mean sea level for azimuths
683 of 0, 45, 90, 135, 180, 225, 270, and 315 degrees, and
684 include such information in the site report generated. If
685 one or more of the eight radials surveyed fall over water,
686 or over regions for which no SDF data is available, S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!
687 reports _
\bN_
\bo _
\bT_
\be_
\br_
\br_
\ba_
\bi_
\bn for the radial paths affected.
689 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
690 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! reads SDF files as needed into a series of memory
691 "slots" within the structure of the program. Each "slot"
692 holds one SDF file representing a one degree by one degree
693 region of terrain. A _
\b#_
\bd_
\be_
\bf_
\bi_
\bn_
\be _
\bM_
\bA_
\bX_
\bS_
\bL_
\bO_
\bT_
\bS statement in the
694 first several lines of _
\bs_
\bp_
\bl_
\ba_
\bt_
\b._
\bc_
\bp_
\bp sets the maximum number
695 of "slots" available for topography data. It also sets
696 the maximum size of the topographic maps generated by
697 S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!. MAXSLOTS is set to 9 by default. If S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! pro-
698 duces a segmentation fault on start-up with this default,
699 it is an indication that not enough RAM and/or virtual
700 memory (swap space) is available to run S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! with this
701 number of MAXSLOTS. In situations where available memory
702 is low, MAXSLOTS may be reduced to 4 with the understand-
703 ing that this will greatly limit the maximum region S
\bSP
\bPL
\bLA
\bAT
\bT!
\b!
704 will be able to analyze. If 118 megabytes or more of
705 total memory (swap space plus RAM) is available, then
706 MAXSLOTS may be increased to 16. This will permit opera-
707 tion over a 4-degree by 4-degree region, which is suffi-
708 cient for single antenna heights in excess of 10,000 feet
709 above mean sea level, or point-to-point distances of over
712 A
\bAD
\bDD
\bDI
\bIT
\bTI
\bIO
\bON
\bNA
\bAL
\bL I
\bIN
\bNF
\bFO
\bOR
\bRM
\bMA
\bAT
\bTI
\bIO
\bON
\bN
713 Invoking S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! without any arguments will display all the
714 command-line options available with the program along with
715 a brief summary of each.
717 The latest news and information regarding S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! software
718 is available through the official S
\bSP
\bPL
\bLA
\bAT
\bT!
\b! software web page
719 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.
721 A
\bAU
\bUT
\bTH
\bHO
\bOR
\bRS
\bS
722 John A. Magliacane, KD2BD <_
\bk_
\bd_
\b2_
\bb_
\bd_
\b@_
\ba_
\bm_
\bs_
\ba_
\bt_
\b._
\bo_
\br_
\bg>
723 Creator, Lead Developer
725 Doug McDonald <_
\bm_
\bc_
\bd_
\bo_
\bn_
\ba_
\bl_
\bd_
\b@_
\bs_
\bc_
\bs_
\b._
\bu_
\bi_
\bu_
\bc_
\b._
\be_
\bd_
\bu>
726 Longley-Rice Model integration