From Fedora Project Wiki
No edit summary
Line 91: Line 91:
Once you have the above files you may invoke SPLAT! to generate a map of transmitter vocerage by invoking it with a command like:
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) \   
  splat -t (transmitting station)  -L (hgt of rcv ant)  -R (max dist to calc) \   
       -s (name of city file) \                 
       -s (name of city file) \                 
       -d (directory for sdf files) \
       -d (directory for sdf files) \
Line 97: Line 97:
       -o Output.ppm                   
       -o Output.ppm                   


The <code>-R</code> 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.
The <code>-R</code> parameter may 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.
 
[[Image:Docs_Amateur_Radio_SPLAT1-small.png]]
 
The legend along the bottom of the image shows the signal strength in log microvolts per meter if the ERP was provided, or the loss in decibels if it was not.

Revision as of 19:50, 30 December 2008

DocsProject Header docTeam1.png


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

Installation

Installing SPLAT! is straightforward:

 su -c 'yum install splat splat-utils'
Note.png
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 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:

 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 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_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:

W8KEA-4
43 38 05
84 15 41
124.0

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.

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 (transmitting station)  -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                   

The -R parameter may 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.

Docs Amateur Radio SPLAT1-small.png

The legend along the bottom of the image shows the signal strength in log microvolts per meter if the ERP was provided, or the loss in decibels if it was not.