From Fedora Project Wiki

< User:Jjmcd‎ | Drafts

Revision as of 13:41, 18 December 2008 by Jjmcd (talk | contribs)

DocsProject Header docTeam1.png

This page is a draft only
It is still under construction and content may change. Do not rely on the information on this page.

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'
In a future release it will not be necessary to install 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

Unzip the nine files and convert them from hgt files to sdf with the srtm2sdf utility. For example:

 srtm2sdf N41W082.hgt

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 and 'census designated areas' from

For each of these, there are two files, an xxyy_d00.dat and 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

The 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.

Using SPLAT!

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:

  1. The name of the station
  2. The latitude of the station
  3. The longitude of the station
  4. The antenna height above ground

Here is an example .qth file:

43 38 05
84 15 41

The .qth file should be named for the station. The name of the file in the above example would be W8KEA-4.qth.

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.

The .lrp file has 9 lines:

  1. 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.
  2. Earth Conductivity
  3. Atmospheric Bending Constant
  4. Frequency
  5. Radio Climate. This is a code describing the terrain. See the table in the man page.
  6. Polarization
  7. 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.
  8. Fraction of time
  9. 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.