Splat
Splat
txt Page 1 of 19
NAME
splat An RF Signal Propagation, Loss, And Terrain analysis tool
SYNOPSIS
splat [-t transmitter_site.qth] [-r receiver_site.qth] [-c rx antenna
height for LOS coverage analysis (feet/meters) (float)] [-L rx antenna
height for Longley-Rice coverage analysis (feet/meters) (float)] [-p
terrain_profile.ext] [-e elevation_profile.ext] [-h height_profile.ext]
[-H normalized_height_profile.ext] [-l Longley-Rice_profile.ext] [-o
topographic_map_filename.ppm] [-b cartographic_boundary_filename.dat]
[-s site/city_database.dat] [-d sdf_directory_path] [-m earth radius
multiplier (float)] [-f frequency (MHz) for Fresnel zone calculations
(float)] [-R maximum coverage radius (miles/kilometers) (float)] [-dB
threshold beyond which contours will not be displayed] [-gc ground
clutter height (feet/meters) (float)] [-fz Fresnel zone clearance per‐
centage (default = 60)] [-ano alphanumeric output file name] [-ani
alphanumeric input file name] [-udt user_defined_terrain_file.dat] [-n]
[-N] [-nf] [-dbm] [-ngs] [-geo] [-kml] [-gpsav] [-metric]
DESCRIPTION
SPLAT! is a powerful terrestrial RF propagation and terrain analysis
tool for the spectrum between 20 MHz and 20 GHz. SPLAT! is free soft‐
ware, and is designed for operation on Unix and Linux-based worksta‐
tions. Redistribution and/or modification is permitted under the terms
of the GNU General Public License, Version 2, as published by the Free
Software Foundation. Adoption of SPLAT! source code in proprietary or
closed-source applications is a violation of this license and is
strictly forbidden.
INTRODUCTION
Applications of SPLAT! include the visualization, design, and link bud‐
get analysis of wireless Wide Area Networks (WANs), commercial and ama‐
teur radio communication systems above 20 MHz, microwave links, fre‐
quency coordination and interference studies, and the prediction of
analog and digital terrestrial radio and television contour regions.
INPUT FILES
SPLAT! is a command-line driven application and reads input data
through a number of data files. Some files are mandatory for success‐
ful execution of the program, while others are optional. Mandatory
files include digital elevation topography models in the form of SPLAT
File: /home/djordje/spl.txt Page 2 of 19
Data Files (SDF files), site location files (QTH files), and Longley-
Rice model parameter files (LRP files). Optional files include city
location files, cartographic boundary files, user-defined terrain
files, path loss input files, antenna radiation pattern files, and
color definition files.
Note that SRTM filenames refer to the latitude and longitude of the
southwest corner of the topographic dataset contained within the file.
Therefore, the region of interest must lie north and east of the lati‐
tude and longitude provided in the SRTM filename.
The srtm2sdf utility may also be used to convert 3-arc second SRTM data
in Band Interleaved by Line (.BIL) format for use with SPLAT!. This
data is available via the web at: http://seamless.usgs.gov/web‐
site/seamless/
High resolution SDF files for use with SPLAT! HD may be generated from
data in this format using the srtm2sdf-hd utility.
Despite the higher accuracy that SRTM data has to offer, some voids in
the data sets exist. When voids are detected, the srtm2sdf and
srtm2sdf-hd utilities replace them with corresponding data found in
usgs2sdf generated SDF files. If USGS-derived SDF data is not avail‐
able, voids are handled through adjacent pixel averaging, or direct
replacement.
WNJT-DT
40.2828
74.6864
990.00
1: Equatorial (Congo)
2: Continental Subtropical (Sudan)
3: Maritime Subtropical (West coast of Africa)
4: Desert (Sahara)
5: Continental Temperate
6: Maritime Temperate, over land (UK and west coasts of US &
EU)
7: Maritime Temperate, over sea
The seventh and eighth parameters in the .lrp file correspond to the
statistical analysis provided by the Longley-Rice model. In this exam‐
ple, SPLAT! will return the maximum path loss occurring 50% of the time
(fraction of time) in 90% of situations (fraction of situations). This
is often denoted as F(50,90) in Longley-Rice studies. In the United
States, an F(50,90) criteria is typically used for digital television
(8-level VSB modulation), while F(50,50) is used for analog (VSB-
AM+NTSC) broadcasts.
A total of five separate city data files may be imported at a time, and
there is no limit to the size of these files. SPLAT! reads city data
on a "first come/first served" basis, and plots only those locations
whose annotations do not conflict with annotations of locations read
earlier in the current city data file, or in previous files. This
behavior minimizes clutter in SPLAT! generated topographic maps, but
File: /home/djordje/spl.txt Page 5 of 19
City data files may be generated manually using any text editor,
imported from other sources, or derived from data available from the
U.S. Census Bureau using the citydecoder utility included with SPLAT!.
Such data is available free of charge via the Internet at:
http://www.census.gov/geo/www/cob/bdy_files.html, and must be in ASCII
format.
PROGRAM OPERATION
SPLAT! is invoked via the command-line using a series of switches and
arguments. Since SPLAT! is a CPU and memory intensive application,
this type of interface minimizes overhead and lends itself well to
scripted (batch) operations. SPLAT!'s CPU and memory scheduling prior‐
ity may be modified through the use of the Unix nice command.
The number and type of switches passed to SPLAT! determine its mode of
operation and method of output data generation. Nearly all of SPLAT!'s
switches may be cascaded in any order on the command line when invoking
the program.
POINT-TO-POINT ANALYSIS
SPLAT! may be used to perform line-of-sight terrain analysis between
two specified site locations. For example:
qth extensions are assumed by SPLAT! for QTH files, and are optional
when specifying -t and -r arguments on the command-line. SPLAT! auto‐
matically reads all SPLAT Data Files necessary to conduct the terrain
analysis between the sites specified. SPLAT! searches for the
required SDF files in the current working directory first. If the
needed files are not found, SPLAT! then searches in the path specified
by the -d command-line switch:
/opt/splat/sdf/
The graph produced using this switch illustrates the elevation and
depression angles resulting from the terrain between the receiver's
location and the transmitter site from the perspective of the
receiver's location. A second trace is plotted between the left side
of the graph (receiver's location) and the location of the transmitting
antenna on the right. This trace illustrates the elevation angle
required for a line-of-sight path to exist between the receiver and
transmitter locations. If the trace intersects the elevation profile
at any point on the graph, then this is an indication that a line-of-
sight path does not exist under the conditions given, and the obstruc‐
tions can be clearly identified on the graph at the point(s) of inter‐
section.
The first Fresnel Zone, and 60% of the first Fresnel Zone can be added
to height profile graphs by adding the -f switch, and specifying a fre‐
quency (in MHz) at which the Fresnel Zone should be modeled:
Fresnel Zone clearances other 60% can be specified using the -fz switch
as follows:
SNR = T - NJ - L + G - NF
T = TI + GT
To compute how much more signal is available over the minimum to neces‐
sary to achieve a specific signal-to-noise ratio:
Signal_Margin = SNR - S
where S is the minimum required SNR ratio (15.5 dB for ATSC (8-level
VSB) DTV, 42 dB for analog NTSC television).
It may desirable to populate the topographic map with names and loca‐
tions of cities, tower sites, or other important locations. A city
file may be passed to SPLAT! using the -s switch:
The -ngs option assigns all terrain to the color white, and can be used
when it is desirable to generate a map that is devoid of terrain:
The resulting .ppm image file can be converted to .png format with a
transparent background using ImageMagick's convert utility:
The -db switch allows a threshold to be set beyond which contours will
not be plotted on the map. For example, if a path loss beyond -140 dB
is irrelevant to the survey being conducted, SPLAT!'s path loss plot
can be constrained to the region bounded by the 140 dB attenuation con‐
tour as follows:
If the path loss is less than 80 dB, the color Red (RGB = 255, 0, 0) is
assigned to the region. If the path loss is greater than or equal to
80 dB, but less than 90 db, then Dark Orange (255, 128, 0) is assigned
to the region. Orange (255, 165, 0) is assigned to regions having a
path loss greater than or equal to 90 dB, but less than 100 dB, and so
on. Greyscale terrain is displayed beyond the 230 dB path loss con‐
tour.
The -db switch can be used in this mode as before to limit the extent
to which field strength contours are plotted. When plotting field
strength contours, however, the argument given is interpreted as being
expressed in dBuV/m.
Signal strength contours for some common VHF and UHF broadcasting ser‐
vices in the United States are as follows:
File: /home/djordje/spl.txt Page 13 of 19
The -db switch can be used to limit the extent to which received power
level contours are plotted. When plotting power level contours, the
argument given is interpreted as being expressed in dBm.
SPLAT! received power level color definition files share a very similar
structure to the color definition files described earlier, except that
the power levels in dBm may be either positive or negative, and are
limited to a range between +40 dBm and -200 dBm:
; and -200 dBm, and "red", "green", and "blue" are the corresponding
; RGB color definitions ranging from 0 to 255 for the region speci‐
fied.
;
; The following parameters may be edited and/or expanded
; for future runs of SPLAT! A total of 32 contour regions
; may be defined in this file.
;
;
+0: 255, 0, 0
-10: 255, 128, 0
-20: 255, 165, 0
-30: 255, 206, 0
-40: 255, 255, 0
-50: 184, 255, 0
-60: 0, 255, 0
-70: 0, 208, 0
-80: 0, 196, 196
-90: 0, 148, 255
-100: 80, 80, 255
-110: 0, 38, 255
-120: 142, 63, 255
-130: 196, 54, 255
-140: 255, 0, 255
-150: 255, 194, 204
For example, the first few lines of a SPLAT! azimuth pattern file might
appear as follows (kvea.az):
183.0
0 0.8950590
1 0.8966406
2 0.8981447
3 0.8995795
4 0.9009535
5 0.9022749
6 0.9035517
7 0.9047923
8 0.9060051
The first line of the .az file specifies the amount of azimuthal pat‐
tern rotation (measured clockwise in degrees from True North) to be
applied by SPLAT! to the data contained in the .az file. This is fol‐
lowed by azimuth headings (0 to 360 degrees) and their associated nor‐
malized field patterns (0.000 to 1.000) separated by whitespace.
The remainder of the file consists of elevation angles and their corre‐
sponding normalized voltage radiation pattern (0.000 to 1.000) values
File: /home/djordje/spl.txt Page 15 of 19
For example, the first few lines a SPLAT! elevation pattern file might
appear as follows (kvea.el):
1.1 130.0
-10.0 0.172
-9.5 0.109
-9.0 0.115
-8.5 0.155
-8.0 0.157
-7.5 0.104
-7.0 0.029
-6.5 0.109
-6.0 0.185
If ERP is specified in the .lrp file or on the command line through the
-erp switch, the alphanumeric output file will instead contain pre‐
dicted field values in dBuV/m. If the -dBm command line switch is
used, then the alphanumeric output file will contain receive signal
power levels in dBm.
The first few lines of a SPLAT! alphanumeric output file could take on
the following appearance (pathloss.dat):
Note as was the case in the antenna pattern files, negative elevation
angles refer to upward tilt (above the horizon), while positive angles
refer to downward tilt (below the horizon). These angles refer to the
elevation to the receiving antenna at the height above ground level
specified using the -L switch if the path between transmitter and
receiver is unobstructed. If the path between the transmitter and
receiver is obstructed, an asterisk (*) is placed on the end of the
line, and the elevation angle returned by SPLAT! refers the elevation
angle to the first obstruction rather than the geographic location
specified on the line. This is done in response to the fact that the
Longley-Rice model considers the energy reaching a distant point over
an obstructed path to be the result of the energy scattered over the
top of the first obstruction along the path. Since energy cannot reach
the obstructed location directly, the actual elevation angle to the
destination over such a path becomes irrelevant.
When modifying SPLAT! path loss files to reflect antenna pattern data,
only the last numeric column should be amended to reflect the antenna's
normalized gain at the azimuth and elevation angles specified in the
file. Programs and scripts capable of performing this task are left as
an exercise for the user.
conducted, but noticeably absent from the SDF files being used. A
user-defined terrain file is imported into a SPLAT! analysis using the
-udt switch:
GROUND CLUTTER
The height of ground clutter can be specified using the -gc switch:
The -gc switch as the effect of raising the overall terrain by the
specified amount in feet (or meters if the -metric switch is invoked),
except over areas at sea-level and at the transmitting and receiving
antenna locations. Note that the addition of ground clutter does not
necessarily modify the Longley-Rice path loss results unless the addi‐
tional clutter height results in a switch in the propagation mode from
a less obstructed path to a more obstructed path (from Line Of Sight to
Single Horizon Diffraction Dominant, for example). It does, however,
affect Fresnel zone clearances and line of sight determinations.
where -R specifies the minimum radius of the map in miles (or kilome‐
ters if the -metric switch is used). Note that the tx_site name and
location are not displayed in this example. If display of this infor‐
mation is desired, simply create a SPLAT! city file (-s option) and
append it to the list of command-line options illustrated above.
The georeference file generated will have the same base name as the -o
file specified, but have a .geo extension, and permit proper interpre‐
tation and display of SPLAT!'s .ppm graphics in Xastir software.
The KML file generated will have the same filename structure as a Path
Analysis Report for the transmitter and receiver site names given,
except it will carry a .kml extension.
Once loaded into Google Earth (File --> Open), the KML file will anno‐
tate the map display with the names of the transmitter and receiver
site locations. The viewpoint of the image will be from the position
of the transmitter site looking towards the location of the receiver.
The point-to-point path between the sites will be displayed as a white
line while the RF line-of-sight path will be displayed in green.
Google Earth's navigation tools allow the user to "fly" around the
path, identify landmarks, roads, and other featured content.
Note that SRTM-3 elevation data, unlike older USGS data, extends beyond
the borders of the United States. Therefore, HAAT results may not be
in full compliance with FCC Part 73.313(d) in areas along the borders
of the United States if the SDF files used by SPLAT! are SRTM-derived.
eight radials surveyed fall over water, or over regions for which no
SDF data is available, SPLAT! reports No Terrain for the radial paths
affected.
ADDITIONAL INFORMATION
The latest news and information regarding SPLAT! software is available
through the official SPLAT! software web page located at:
http://www.qsl.net/kd2bd/splat.html.
AUTHORS
John A. Magliacane, KD2BD <[email protected]>
Creator, Lead Developer