How to use SPLAT!
SPLAT! is a Surface Path Length And Terrain analysis application which can perform path loss calculations as well as generate coverage maps.
Installing SPLAT! is straightforward:
su -c 'yum install splat splat-utils'
Obtaining terrain files
Before it can be useful, SPLAT requires files that describe the terrain around the station to be modelled. First, determine the latitude and longitude of the station. Then download the nine terrain files centered on that latitude and longitude from http://e0srp01u.ecs.nasa.gov/srtm/version2/SRTM3/
Unzip the nine files and convert them from
hgt files to
sdf with the
srtm2sdf utility. For example:
Do this for each of the nine files. Those files can now be placed in a directory where you wish to store terrain files, or they can be placed in the directory where you wish to work with SPLAT!
If you will be modelling stations over a wide geographic area, you may wish to download and convert additional files. SPLAT! will select those files it requires for a particular calculation.
Obtaining cartographic boundary files
SPLAT! will work with just the terrain files. However, for path loss maps, the resulting maps can be more useful if they are marked with political boundaries and names of towns and cities. For the United States, county outlines can be downloaded from http://www.census.gov/geo/www/cob/co2000.html#ascii and 'census designated areas' from http://www.census.gov/geo/www/cob/pl2000.html#ascii.
For each of these, there are two files, an
xxyy_d00a.dat, where xx is '
co' for county and '
pl' for place, and yy is a state number. A file of place names can be generated from the 'a' file with the
citydecoder utility. For example:
citydecoder pl37 >cities.dat
cities.dat file is simply a list of names followed by latitude and longitude. You may edit the file with a text editor to insert additional places which will be marked on the map with a red dot.
SPLAT! can perform calculations for a particular path, or generate a map showing path loss or signal strength over a region. In any case SPLAT! needs at least one file identifying the transmitter location. For a specific path, it needs an identical file for the receiver. If you would like signal strength calculations, you will need another file with more details about the transmitter.
The QTH file
You tell SPLAT! about a particular station (transmitter or receiver) with a
.qth file. This file has four lines:
- The name of the station
- The latitude of the station
- The longitude of the station
- The antenna height above ground
Here is an example
W8KEA-4 43 38 05 84 15 41 124.0
.qth file should be named for the station. The name of the file in the above example would be
By default, SPLAT! uses British units; heights are in feet, distances are in miles. However, there is a switch to specify metric units.
The LRP file
If you would like SPLAT! to calculate signal strengths, it needs to know a little more about the transmitter. You provide this information in a file whose name matches that of the
.qth file but has an extension of
.lrp file has 9 lines:
- Earth Dielectric Constant. If you do not have measured data available, the SPLAT! man page has a table that can help you estimate a value.
- Earth Conductivity
- Atmospheric Bending Constant
- Radio Climate. This is a code describing the terrain. See the table in the man page.
- Fraction of situations. This and the following line reflect how the Longley-Rice calculations are to be carried out. In the example below, SPLAT! will calculate the maximum path loss experienced 50% of the time in 50% of the situations.
- Fraction of time
- Effective radiated power - power out less feedline loss times antenna gain
15.000 ; Earth Dielectric Constant (Relative permittivity) 0.005 ; Earth Conductivity (Siemens per meter) 301.000 ; Atmospheric Bending Constant (N-Units) 145.090 ; Frequency in MHz (20 MHz to 20 GHz) 5 ; Radio Climate 1 ; Polarization (0 = Horizontal, 1 = Vertical) 0.50 ; Fraction of situations 0.50 ; Fraction of time 126.00 ; ERP
You may leave out the last line in which case SPLAT! will calculate only path loss.
Making a map of coverage
Once you have the above files you may invoke SPLAT! to generate a map of transmitter vocerage by invoking it with a command like:
splat -t W8KEA -L (hgt of rcv ant) -R (max dist to calc) \ -s (name of city file) \ -d (directory for sdf files) \ -b (county and place outline files) \ -o Output.ppm
-R parameter will be omitted, in which case SPLAT! will use a default. Selecting a larger calculation area will slow the calculation. The default area may not show the weaker areas but instead be cut off at some fixed distance.