Imported Debian patch 1.2.1-1
[debian/splat] / docs / english / man / splat.1
diff --git a/docs/english/man/splat.1 b/docs/english/man/splat.1
new file mode 100644 (file)
index 0000000..7a47afa
--- /dev/null
@@ -0,0 +1,1289 @@
+SPLAT!(1)                 KD2BD Software                SPLAT!(1)
+
+
+
+N\bNA\bAM\bME\bE
+       splat - An RF S\bSignal P\bPropagation, L\bLoss, A\bAnd T\bTerrain analy-
+       sis tool
+
+S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
+       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]
+       [-c   _\br_\bx   _\ba_\bn_\bt_\be_\bn_\bn_\ba   _\bh_\be_\bi_\bg_\bh_\bt   _\bf_\bo_\br  _\bL_\bO_\bS  _\bc_\bo_\bv_\be_\br_\ba_\bg_\be  _\ba_\bn_\ba_\bl_\by_\bs_\bi_\bs
+       _\b(_\bf_\be_\be_\bt_\b/_\bm_\be_\bt_\be_\br_\bs_\b) _\b(_\bf_\bl_\bo_\ba_\bt_\b)] [-L _\br_\bx _\ba_\bn_\bt_\be_\bn_\bn_\ba _\bh_\be_\bi_\bg_\bh_\bt _\bf_\bo_\br  _\bL_\bo_\bn_\bg_\bl_\be_\by_\b-
+       _\bR_\bi_\bc_\be  _\bc_\bo_\bv_\be_\br_\ba_\bg_\be  _\ba_\bn_\ba_\bl_\by_\bs_\bi_\bs  _\b(_\bf_\be_\be_\bt_\b/_\bm_\be_\bt_\be_\br_\bs_\b)  _\b(_\bf_\bl_\bo_\ba_\bt_\b)] [-p _\bt_\be_\br_\b-
+       _\br_\ba_\bi_\bn_\b__\bp_\br_\bo_\bf_\bi_\bl_\be_\b._\be_\bx_\bt]    [-e    _\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] [-H _\bn_\bo_\br_\bm_\ba_\bl_\bi_\bz_\be_\bd_\b__\bh_\be_\bi_\bg_\bh_\bt_\b__\bp_\br_\bo_\bf_\bi_\bl_\be_\b._\be_\bx_\bt] [-l
+       _\bL_\bo_\bn_\bg_\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_\b-
+       _\bn_\ba_\bm_\be_\b._\bp_\bp_\bm]   [-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
+       _\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  _\be_\ba_\br_\bt_\bh
+       _\br_\ba_\bd_\bi_\bu_\bs _\bm_\bu_\bl_\bt_\bi_\bp_\bl_\bi_\be_\br _\b(_\bf_\bl_\bo_\ba_\bt_\b)] [-f _\bf_\br_\be_\bq_\bu_\be_\bn_\bc_\by _\b(_\bM_\bH_\bz_\b) _\bf_\bo_\br _\bF_\br_\be_\bs_\bn_\be_\bl
+       _\bz_\bo_\bn_\be _\bc_\ba_\bl_\bc_\bu_\bl_\ba_\bt_\bi_\bo_\bn_\bs _\b(_\bf_\bl_\bo_\ba_\bt_\b)]  [-R  _\bm_\ba_\bx_\bi_\bm_\bu_\bm  _\bc_\bo_\bv_\be_\br_\ba_\bg_\be  _\br_\ba_\bd_\bi_\bu_\bs
+       _\b(_\bm_\bi_\bl_\be_\bs_\b/_\bk_\bi_\bl_\bo_\bm_\be_\bt_\be_\br_\bs_\b)  _\b(_\bf_\bl_\bo_\ba_\bt_\b)] [-dB _\bm_\ba_\bx_\bi_\bm_\bu_\bm _\ba_\bt_\bt_\be_\bn_\bu_\ba_\bt_\bi_\bo_\bn _\bc_\bo_\bn_\b-
+       _\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 _\bd_\bB_\b)] [-fz  _\bF_\br_\be_\bs_\b-
+       _\bn_\be_\bl  _\bz_\bo_\bn_\be  _\bc_\bl_\be_\ba_\br_\ba_\bn_\bc_\be  _\bp_\be_\br_\bc_\be_\bn_\bt_\ba_\bg_\be  _\b(_\bd_\be_\bf_\ba_\bu_\bl_\bt  _\b=  _\b6_\b0_\b)]  [-plo
+       _\bp_\ba_\bt_\bh_\b__\bl_\bo_\bs_\bs_\b__\bo_\bu_\bt_\bp_\bu_\bt_\b__\bf_\bi_\bl_\be_\b._\bt_\bx_\bt] [-pli _\bp_\ba_\bt_\bh_\b__\bl_\bo_\bs_\bs_\b__\bi_\bn_\bp_\bu_\bt_\b__\bf_\bi_\bl_\be_\b._\bt_\bx_\bt]
+       [-udt   _\bu_\bs_\be_\br_\b__\bd_\be_\bf_\bi_\bn_\be_\bd_\b__\bt_\be_\br_\br_\ba_\bi_\bn_\b__\bf_\bi_\bl_\be_\b._\bd_\ba_\bt]   [-n]  [-N]  [-nf]
+       [-ngs] [-geo] [-kml] [-metric]
+
+D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
+       S\bSP\bPL\bLA\bAT\bT!\b! is a powerful terrestrial RF propagation  and  ter-
+       rain  analysis tool for the spectrum between 20 MHz and 20
+       GHz.  S\bSP\bPL\bLA\bAT\bT!\b! is free software, and is designed for  opera-
+       tion on Unix and Linux-based workstations.  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 S\bSP\bPL\bLA\bAT\bT!\b!  source code
+       in  proprietary  or closed-source applications is a viola-
+       tion of this license and is s\bst\btr\bri\bic\bct\btl\bly\by forbidden.
+
+       S\bSP\bPL\bLA\bAT\bT!\b! is distributed in the hope that it will be  useful,
+       but  WITHOUT  ANY  WARRANTY, without even the implied war-
+       ranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PUR-
+       POSE.   See  the  GNU  General  Public  License  for  more
+       details.
+
+I\bIN\bNT\bTR\bRO\bOD\bDU\bUC\bCT\bTI\bIO\bON\bN
+       Applications of S\bSP\bPL\bLA\bAT\bT!\b! include the visualization,  design,
+       and  link  budget  analysis of wireless Wide Area Networks
+       (WANs), commercial and amateur radio communication systems
+       above  20 MHz, microwave links, frequency coordination and
+       interference studies, and the  prediction  of  analog  and
+       digital  terrestrial radio and television contour regions.
+
+       S\bSP\bPL\bLA\bAT\bT!\b! provides RF site engineering  data  such  as  great
+       circle  distances and bearings between sites, antenna ele-
+       vation  angles  (uptilt),  depression  angles  (downtilt),
+       antenna  height above mean sea level, antenna height above
+       average terrain, bearings, distances,  and  elevations  to
+       known  obstructions,  Longley-Rice  path  attenuation, and
+       received  signal  strength.   In  addition,  the   minimum
+       antenna  height  requirements needed to clear terrain, the
+       first Fresnel zone, and any user-definable  percentage  of
+       the first Fresnel zone are also provided.
+
+       S\bSP\bPL\bLA\bAT\bT!\b! produces reports, graphs, and high resolution topo-
+       graphic maps that depict line-of-sight paths, and regional
+       path  loss  and  signal  strength  contours  through which
+       expected coverage areas of transmitters and repeater  sys-
+       tems  can  be obtained.  When performing line-of-sight and
+       Longley-Rice analyses in situations where multiple  trans-
+       mitter  or  repeater sites are employed, S\bSP\bPL\bLA\bAT\bT!\b! determines
+       individual and mutual areas of coverage within the network
+       specified.
+
+       Simply typing splat on the command line will return a sum-
+       mary of S\bSP\bPL\bLA\bAT\bT!\b!'s command line options:
+
+
+                    --==[  SPLAT!  v1.2.1  Available   Options...
+       ]==--
+
+            -t  txsite(s).qth  (max  of 4 with -c, max of 30 with
+       -L)
+            -r rxsite.qth
+            -c plot coverage of TX(s) with an  RX  antenna  at  X
+       feet/meters AGL
+            -L  plot  path  loss  map  of  TX based on an RX at X
+       feet/meters AGL
+            -s filename(s) of city/site file(s) to import (5 max)
+            -b  filename(s)  of  cartographic boundary file(s) to
+       import (5 max)
+            -p filename of terrain profile graph to plot
+            -e filename of terrain elevation graph to plot
+            -h filename of terrain height graph to plot
+            -H filename of normalized  terrain  height  graph  to
+       plot
+            -l filename of Longley-Rice graph to plot
+            -o filename of topographic map to generate (.ppm)
+            -u filename of user-defined terrain file to import
+            -d   sdf  file  directory  path  (overrides  path  in
+       ~/.splat_path file)
+            -m earth radius multiplier
+            -n do not plot LOS paths in .ppm maps
+            -N do not produce  unnecessary  site  or  obstruction
+       reports
+            -f frequency for Fresnel zone calculation (MHz)
+            -R  modify  default range for -c or -L (miles/kilome-
+       ters)
+           -db maximum loss contour to display on path loss  maps
+       (80-230 dB)
+           -nf do not plot Fresnel zones in height plots
+           -fz Fresnel zone clearance percentage (default = 60)
+          -ngs  display  greyscale  topography  as  white in .ppm
+       files
+          -erp override ERP in .lrp file (Watts)
+          -pli filename of path-loss input file
+          -plo filename of path-loss output file
+          -udt filename of user defined terrain input file
+          -kml generate Google Earth (.kml) compatible output
+          -geo generate an Xastir .geo  georeference  file  (with
+       .ppm  output)  -metric  employ metric rather than imperial
+       units for all user I/O
+
+
+I\bIN\bNP\bPU\bUT\bT F\bFI\bIL\bLE\bES\bS
+       S\bSP\bPL\bLA\bAT\bT!\b! is a  command-line  driven  application  and  reads
+       input data through a number of data files.  Some files are
+       mandatory for successful execution of the  program,  while
+       others are optional.  Mandatory files include 3-arc second
+       topography models in the form of  SPLAT  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.
+
+S\bSP\bPL\bLA\bAT\bT D\bDA\bAT\bTA\bA F\bFI\bIL\bLE\bES\bS
+       S\bSP\bPL\bLA\bAT\bT!\b!  imports topographic data in the form of SPLAT Data
+       Files (SDFs).  These files may be generated from a  number
+       of  information sources.  In the United States, SPLAT Data
+       Files can be generated  through  U.S.   Geological  Survey
+       Digital Elevation Models (DEMs) using the u\bus\bsg\bgs\bs2\b2s\bsd\bdf\bf utility
+       included with S\bSP\bPL\bLA\bAT\bT!\b!.  USGS Digital Elevation Models  com-
+       patible   with   this  utility  may  be  downloaded  from:
+       _\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/.
+
+       Significantly  better  resolution  and  accuracy  can   be
+       obtained  through the use of SRTM-3 Version 2 digital ele-
+       vation models.  These models are the product of the STS-99
+       Space  Shuttle Radar Topography Mission, and are available
+       for most populated regions of the Earth.  SPLAT Data Files
+       may  be  generated  from  SRTM  data  using  the  included
+       s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf utility.  SRTM-3 Version 2 data may  be  obtained
+       through            anonymous           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/
+
+       The s\bst\btr\brm\bm2\b2s\bsd\bdf\bf utility may also be  used  to  convert  3-arc
+       second SRTM data in Band Interleaved by Line (.BIL) format
+       for use with S\bSP\bPL\bLA\bAT\bT!\b!.  This data is available via  the  web
+       at: _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bs_\be_\ba_\bm_\bl_\be_\bs_\bs_\b._\bu_\bs_\bg_\bs_\b._\bg_\bo_\bv_\b/_\bw_\be_\bb_\bs_\bi_\bt_\be_\b/_\bs_\be_\ba_\bm_\bl_\be_\bs_\bs_\b/
+
+       Band Interleaved by Line data must be downloaded in a very
+       specific manner to be compatible with s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf and S\bSP\bPL\bLA\bAT\bT!\b!.
+       Please  consult  s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf's documentation for instructions
+       on downloading .BIL topographic data  through  the  USGS's
+       Seamless Web Site.
+
+       Despite  the  higher accuracy that SRTM data has to offer,
+       some voids  in  the  data  sets  exist.   When  voids  are
+       detected,  the  s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf utility replaces them with corre-
+       sponding data found in existing SDF files (that were  pre-
+       sumably   created  from  earlier  USGS  data  through  the
+       u\bus\bsg\bgs\bs2\b2s\bsd\bdf\bf utility).  If USGS-derived SDF data is not avail-
+       able,  voids are handled through adjacent pixel averaging,
+       or direct replacement.
+
+       SPLAT Data Files contain integer value topographic  eleva-
+       tions  (in  meters)  referenced  to  mean  sea  level  for
+       1-degree by 1-degree regions of the earth with  a  resolu-
+       tion  of  3-arc  seconds.  SDF files can be read in either
+       standard format (_\b._\bs_\bd_\bf) as generated by  the  u\bus\bsg\bgs\bs2\b2s\bsd\bdf\bf  and
+       s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf   utilities,   or   in  bzip2  compressed  format
+       (_\b._\bs_\bd_\bf_\b._\bb_\bz_\b2).  Since uncompressed files can be read slightly
+       faster  than  files  that  have  been  compressed,  S\bSP\bPL\bLA\bAT\bT!\b!
+       searches for needed SDF data in uncompressed format first.
+       If  uncompressed  data  cannot  be  located,  S\bSP\bPL\bLA\bAT\bT!\b!  then
+       searches for data in bzip2 compressed format.  If no  com-
+       pressed  SDF  files can be found for the region requested,
+       S\bSP\bPL\bLA\bAT\bT!\b! assumes the region is over water, and  will  assign
+       an elevation of sea-level to these areas.
+
+       This  feature  of S\bSP\bPL\bLA\bAT\bT!\b! makes it possible to perform path
+       analysis not only over  land,  but  also  between  coastal
+       areas  not  represented  by  Digital Elevation Model data.
+       However, this behavior of S\bSP\bPL\bLA\bAT\bT!\b!  underscores  the  impor-
+       tance  of having all the SDF files required for the region
+       being analyzed if meaningful results are to be expected.
+
+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
+       S\bSP\bPL\bLA\bAT\bT!\b! imports site location  information  of  transmitter
+       and  receiver  sites  analyzed  by  the program from ASCII
+       files having a _\b._\bq_\bt_\bh  extension.   QTH  files  contain  the
+       site's name, the site's latitude (positive if North of the
+       equator, negative if  South),  the  site's  longitude  (in
+       degrees  West, 0 to 360 degrees, or degrees East 0 to -360
+       degrees), and the site's antenna height above ground level
+       (AGL),  each  separated  by  a single line-feed character.
+       The antenna height is assumed  to  be  specified  in  feet
+       unless  followed  by  the  letter  _\bm or the word _\bm_\be_\bt_\be_\br_\bs in
+       either upper or lower case.  Latitude and longitude infor-
+       mation may be expressed in either decimal format (74.6864)
+       or degree, minute, second (DMS) format (74 41 11.0).
+
+       For example, a site location  file  describing  television
+       station  WNJT-DT,  Trenton, NJ (_\bw_\bn_\bj_\bt_\b-_\bd_\bt_\b._\bq_\bt_\bh) might read as
+       follows:
+
+               WNJT-DT
+               40.2828
+               74.6864
+               990.00
+
+       Each transmitter and receiver site analyzed by S\bSP\bPL\bLA\bAT\bT!\b! must
+       be represented by its own site location (QTH) file.
+
+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
+       Longley-Rice  parameter data files are required for S\bSP\bPL\bLA\bAT\bT!\b!
+       to determine RF path loss in either point-to-point or area
+       prediction  mode.   Longley-Rice  model  parameter data is
+       read from files having the same base name as the transmit-
+       ter site QTH file, but with a format (_\bw_\bn_\bj_\bt_\b-_\bd_\bt_\b._\bl_\br_\bp):
+
+               15.000  ; Earth Dielectric Constant (Relative per-
+       mittivity)
+               0.005   ; Earth Conductivity (Siemens per meter)
+               301.000 ; Atmospheric Bending Constant (N-units)
+               647.000 ; Frequency in MHz (20 MHz to 20 GHz)
+               5       ; Radio Climate (5 =  Continental  Temper-
+       ate)
+               0       ; Polarization (0 = Horizontal, 1 = Verti-
+       cal)
+               0.50    ; Fraction of  situations  (50%  of  loca-
+       tions)
+               0.90    ; Fraction of time (90% of the time)
+               46000.0 ; ERP in Watts (optional)
+
+       If  an LRP file corresponding to the tx_site QTH file can-
+       not be found, S\bSP\bPL\bLA\bAT\bT!\b! scans the current  working  directory
+       for  the  file "splat.lrp".  If this file cannot be found,
+       then default parameters will be assigned by S\bSP\bPL\bLA\bAT\bT!\b!  and  a
+       corresponding  "splat.lrp"  file  containing these default
+       parameters will be written to the current  working  direc-
+       tory.   The  generated "splat.lrp" file can then be edited
+       by the user as needed.
+
+       Typical Earth dielectric constants and conductivity values
+       are as follows:
+
+                                  Dielectric Constant  Conductiv-
+       ity
+               Salt water       :        80                5.000
+               Good ground      :        25                0.020
+               Fresh water      :        80                0.010
+               Marshy land      :        12                0.007
+               Farmland, forest :        15                0.005
+               Average ground   :        15                0.005
+               Mountain, sand   :        13                0.002
+               City             :         5                0.001
+               Poor ground      :         4                0.001
+
+       Radio climate codes used by S\bSP\bPL\bLA\bAT\bT!\b! are as follows:
+
+               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  Continental Temperate climate is common to large land
+       masses in the temperate zone, such as the  United  States.
+       For  paths shorter than 100 km, there is little difference
+       between Continental and Maritime Temperate climates.
+
+       The seventh and eighth parameters in the _\b._\bl_\br_\bp file  corre-
+       spond to the statistical analysis provided by the Longley-
+       Rice model.  In this example, S\bSP\bPL\bLA\bAT\bT!\b! will return the maxi-
+       mum 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.
+
+       For  further  information  on   these   parameters,   see:
+       _\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
+       _\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-
+       _\bl_\be_\by_\b__\br_\bi_\bc_\be_\b._\bh_\bt_\bm_\bl
+
+       The  final  parameter  in the _\b._\bl_\br_\bp file corresponds to the
+       transmitter's effective radiated power, and  is  optional.
+       If  it  is included in the levels and field strength level
+       contours when performing  Longley-Rice  studies.   If  the
+       parameter  is omitted, path loss is computed instead.  The
+       ERP provided in the _\b._\bl_\br_\bp file can be overridden  by  using
+       S\bSP\bPL\bLA\bAT\bT!\b!'s  _\b-_\be_\br_\bp command-line switch.  If the _\b._\bl_\br_\bp file con-
+       tains an ERP parameter and  the  generation  of  path-loss
+       rather  than  signal strength contours is desired, the ERP
+       can be assigned to zero using the _\b-_\be_\br_\bp switch without hav-
+       ing to edit the _\b._\bl_\br_\bp file to accomplish the same result.
+
+C\bCI\bIT\bTY\bY L\bLO\bOC\bCA\bAT\bTI\bIO\bON\bN F\bFI\bIL\bLE\bES\bS
+       The  names  and locations of cities, tower sites, or other
+       points of interest may be imported and  plotted  on  topo-
+       graphic  maps  generated  by  S\bSP\bPL\bLA\bAT\bT!\b!.   S\bSP\bPL\bLA\bAT\bT!\b! imports the
+       names of cities and locations from ASCII files  containing
+       the  location of interest's name, latitude, and longitude.
+       Each field is separated by a comma.  Each record is  sepa-
+       rated  by  a  single line feed character.  As was the case
+       with the _\b._\bq_\bt_\bh files, latitude  and  longitude  information
+       may be entered in either decimal or degree, minute, second
+       (DMS) format.
+
+       For example (_\bc_\bi_\bt_\bi_\be_\bs_\b._\bd_\ba_\bt):
+
+               Teaneck, 40.891973, 74.014506
+               Tenafly, 40.919212, 73.955892
+               Teterboro, 40.859511, 74.058908
+               Tinton Falls, 40.279966, 74.093924
+               Toms River, 39.977777, 74.183580
+               Totowa, 40.906160, 74.223310
+               Trenton, 40.219922, 74.754665
+
+       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.  S\bSP\bPL\bLA\bAT\bT!\b! reads city  data  on  a  "first  come/first
+       served"  basis, and plots only those locations whose anno-
+       tations do not conflict with annotations of locations read
+       earlier  in  the  current  city  data file, or in previous
+       files.  This behavior minimizes clutter in  S\bSP\bPL\bLA\bAT\bT!\b!  gener-
+       ated  topographic  maps,  but also mandates that important
+       locations be placed toward the beginning of the first city
+       data file, and locations less important be positioned fur-
+       ther down the list or in subsequent data files.
+
+       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  c\bci\bit\bty\byd\bde\be-\b-
+       c\bco\bod\bde\ber\br  utility  included with S\bSP\bPL\bLA\bAT\bT!\b!.  Such data is avail-
+       able free of charge via the Internet  at:  _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bc_\be_\bn_\b-
+       _\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
+       format.
+
+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
+       Cartographic boundary data may also be  imported  to  plot
+       the  boundaries  of  cities,  counties, or states on topo-
+       graphic maps generated by S\bSP\bPL\bLA\bAT\bT!\b!.  Such data  must  be  of
+       the  form  of  ARC/INFO Ungenerate (ASCII Format) Metadata
+       Cartographic Boundary Files, and are  available  from  the
+       U.S.   Census  Bureau via the Internet at: _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bc_\be_\bn_\b-
+       _\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-
+       _\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
+       separate cartographic boundary files may be imported at  a
+       time.   It  is not necessary to import state boundaries if
+       county boundaries have already been imported.
+
+P\bPR\bRO\bOG\bGR\bRA\bAM\bM O\bOP\bPE\bER\bRA\bAT\bTI\bIO\bON\bN
+       S\bSP\bPL\bLA\bAT\bT!\b! is invoked via the command-line using a  series  of
+       switches  and arguments.  Since S\bSP\bPL\bLA\bAT\bT!\b! is a CPU and memory
+       intensive application, this type  of  interface  minimizes
+       overhead  and lends itself well to scripted (batch) opera-
+       tions.  S\bSP\bPL\bLA\bAT\bT!\b!'s CPU and memory scheduling priority may be
+       modified through the use of the Unix n\bni\bic\bce\be command.
+
+       The number and type of switches passed to S\bSP\bPL\bLA\bAT\bT!\b! determine
+       its mode of operation and method of  output  data  genera-
+       tion.   Nearly all of S\bSP\bPL\bLA\bAT\bT!\b!'s switches may be cascaded in
+       any order on the command line when invoking the program.
+
+       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
+       _\bm_\bo_\bd_\be,  and  _\ba_\br_\be_\ba  _\bp_\br_\be_\bd_\bi_\bc_\bt_\bi_\bo_\bn _\bm_\bo_\bd_\be.  Either a line-of-sight
+       (LOS) or Longley-Rice Irregular Terrain (ITM)  propagation
+       model may be invoked by the user.  True Earth, four-thirds
+       Earth, or any other user-defined Earth radius may be spec-
+       ified when performing line-of-sight analysis.
+
+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
+       S\bSP\bPL\bLA\bAT\bT!\b! may be used to perform line-of-sight terrain analy-
+       sis between two specified site locations.  For example:
+
+       splat -t tx_site.qth -r rx_site.qth
+
+       invokes  a  line-of-sight  terrain  analysis  between  the
+       transmitter  specified  in _\bt_\bx_\b__\bs_\bi_\bt_\be_\b._\bq_\bt_\bh and receiver speci-
+       fied in _\br_\bx_\b__\bs_\bi_\bt_\be_\b._\bq_\bt_\bh using a True Earth radius  model,  and
+       writes  a S\bSP\bPL\bLA\bAT\bT!\b! Path Analysis Report to the current work-
+       ing directory.  The report contains details of the  trans-
+       mitter  and receiver sites, and identifies the location of
+       any obstructions detected along  the  line-of-sight  path.
+       If  an  obstruction  can be cleared by raising the receive
+       antenna to a greater altitude, S\bSP\bPL\bLA\bAT\bT!\b!  will  indicate  the
+       minimum  antenna  height required for a line-of-sight path
+       to exist between the transmitter  and  receiver  locations
+       specified.   Note  that  imperial  units (miles, feet) are
+       specified unless the _\b-_\bm_\be_\bt_\br_\bi_\bc switch is added  to  S\bSP\bPL\bLA\bAT\bT!\b!'s
+       command line options:
+
+       splat -t tx_site.qth -r rx_site.qth -metric
+
+       If  the  antenna must be raised a significant amount, this
+       determination may take  a  few  moments.   Note  that  the
+       results  provided are the _\bm_\bi_\bn_\bi_\bm_\bu_\bm necessary for a line-of-
+       sight path to exist, and in the case of this simple  exam-
+       ple,  do not take Fresnel zone clearance requirements into
+       consideration.
+
+       _\bq_\bt_\bh extensions are assumed by S\bSP\bPL\bLA\bAT\bT!\b! for  QTH  files,  and
+       are  optional  when  specifying -t and -r arguments on the
+       command-line.  S\bSP\bPL\bLA\bAT\bT!\b! automatically reads all  SPLAT  Data
+       Files  necessary  to  conduct the terrain analysis between
+       the sites specified.  S\bSP\bPL\bLA\bAT\bT!\b!  searches  for  the  required
+       SDF  files in the current working directory first.  If the
+       needed files are not found, S\bSP\bPL\bLA\bAT\bT!\b! then  searches  in  the
+       path specified by the _\b-_\bd command-line switch:
+
+       splat -t tx_site -r rx_site -d /cdrom/sdf/
+
+       An  external  directory path may be specified by placing a
+       ".splat_path" file under the user's home directory.   This
+       file  must  contain the full directory path of last resort
+       to all the SDF files.  The path in  the  _\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 line of ASCII text:
+
+       /opt/splat/sdf/
+
+       and can be generated using any text editor.
+
+       A  graph  of  the terrain profile between the receiver and
+       transmitter locations as a function of distance  from  the
+       receiver can be generated by adding the _\b-_\bp switch:
+
+       splat -t tx_site -r rx_site -p terrain_profile.png
+
+       S\bSP\bPL\bLA\bAT\bT!\b!  invokes g\bgn\bnu\bup\bpl\blo\bot\bt when generating graphs.  The file-
+       name extension specified to S\bSP\bPL\bLA\bAT\bT!\b! determines  the  format
+       of  the graph produced.  _\b._\bp_\bn_\bg will produce a 640x480 color
+       PNG graphic file, while _\b._\bp_\bs or  _\b._\bp_\bo_\bs_\bt_\bs_\bc_\br_\bi_\bp_\bt  will  produce
+       postscript  output.   Output in formats such as GIF, Adobe
+       Illustrator, AutoCAD  dxf,  LaTeX,  and  many  others  are
+       available.  Please consult g\bgn\bnu\bup\bpl\blo\bot\bt, and g\bgn\bnu\bup\bpl\blo\bot\bt's documen-
+       tation for details on all the supported output formats.
+
+       A graph of elevations subtended by the terrain between the
+       receiver  and  transmitter  as a function of distance from
+       the receiver can be generated by using the _\b-_\be switch:
+
+       splat -t tx_site -r rx_site -e elevation_profile.png
+
+       The graph produced using this switch illustrates the  ele-
+       vation  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  eleva-
+       tion  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
+       obstructions can be clearly identified on the graph at the
+       point(s) of intersection.
+
+       A  graph illustrating terrain height referenced to a line-
+       of-sight path between the transmitter and receiver may  be
+       generated using the _\b-_\bh switch:
+
+       splat -t tx_site -r rx_site -h height_profile.png
+
+       A  terrain  height  plot normalized to the transmitter and
+       receiver antenna heights can  be  obtained  using  the  _\b-_\bH
+       switch:
+
+       splat  -t  tx_site  -r  rx_site  -H normalized_height_pro-
+       file.png
+
+       A contour of the Earth's curvature is also plotted in this
+       mode.
+
+       The  first Fresnel Zone, and 60% of the first Fresnel Zone
+       can be added to height profile graphs  by  adding  the  _\b-_\bf
+       switch,  and  specifying a frequency (in MHz) at which the
+       Fresnel Zone should be modeled:
+
+       splat  -t  tx_site  -r  rx_site  -f  439.250  -H   normal-
+       ized_height_profile.png
+
+       Fresnel  Zone  clearances other 60% can be specified using
+       the _\b-_\bf_\bz switch as follows:
+
+       splat  -t  tx_site  -r  rx_site  -f  439.250  -fz  75   -H
+       height_profile2.png
+
+       A  graph  showing  Longley-Rice  path  loss may be plotted
+       using the _\b-_\bl switch:
+
+       splat -t tx_site -r rx_site -l path_loss_profile.png
+
+       As before, adding the _\b-_\bm_\be_\bt_\br_\bi_\bc switch forces the graphs  to
+       be plotted using metric units of measure.
+
+       When  performing  a point-to-point analysis, a S\bSP\bPL\bLA\bAT\bT!\b! Path
+       Analysis Report is generated in the form of  a  text  file
+       with a _\b._\bt_\bx_\bt filename extension.  The report contains bear-
+       ings and distances between the transmitter  and  receiver,
+       as  well  as the free-space and Longley-Rice path loss for
+       the path being analyzed.  The mode of propagation for  the
+       path  is  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_\bz_\bo_\bn, _\bD_\bi_\bf_\bf_\br_\ba_\bc_\bt_\bi_\bo_\bn _\bD_\bo_\bm_\bi_\bn_\ba_\bn_\bt, or _\bT_\br_\bo_\bp_\bo_\bs_\bc_\ba_\bt_\bt_\be_\br _\bD_\bo_\bm_\bi_\bn_\ba_\bn_\bt.
+
+       Distances and locations to known  obstructions  along  the
+       path  between  transmitter and receiver are also provided.
+       If the transmitter's effective radiated power is specified
+       in  the  transmitter's  corresponding _\b._\bl_\br_\bp file, then pre-
+       dicted signal strength and antenna voltage at the  receiv-
+       ing location is also provided in the Path Analysis Report.
+
+       To determine the signal-to-noise  (SNR)  ratio  at  remote
+       location  where random Johnson (thermal) noise is the pri-
+       mary limiting factor in reception:
+
+       _\bS_\bN_\bR=_\bT-_\bN_\bJ-_\bL+_\bG-_\bN_\bF
+
+       where T\bT is the ERP of the transmitter in dBW in the direc-
+       tion of the receiver, N\bNJ\bJ is Johnson Noise in dBW (-136 dBW
+       for a 6 MHz television channel), L\bL is the path  loss  pro-
+       vided  by  S\bSP\bPL\bLA\bAT\bT!\b!   in dB (as a _\bp_\bo_\bs_\bi_\bt_\bi_\bv_\be number), G\bG is the
+       receive antenna gain in dB over isotropic, and N\bNF\bF  is  the
+       receiver noise figure in dB.
+
+       T\bT may be computed as follows:
+
+       _\bT=_\bT_\bI+_\bG_\bT
+
+       where  T\bTI\bI  is  actual  amount of RF power delivered to the
+       transmitting  antenna  in  dBW,  G\bGT\bT  is  the  transmitting
+       antenna  gain  (over  isotropic)  in  the direction of the
+       receiver (or the horizon if the receiver is over the hori-
+       zon).
+
+       To compute how much more signal is available over the min-
+       imum to necessary to achieve  a  specific  signal-to-noise
+       ratio:
+
+       _\bS_\bi_\bg_\bn_\ba_\bl__\bM_\ba_\br_\bg_\bi_\bn=_\bS_\bN_\bR-_\bS
+
+       where  S\bS  is  the  minimum required SNR ratio (15.5 dB for
+       ATSC (8-level VSB) DTV, 42 dB for analog NTSC television).
+
+       A  topographic map may be generated by S\bSP\bPL\bLA\bAT\bT!\b! to visualize
+       the path between the transmitter and receiver  sites  from
+       yet  another  perspective.   Topographic maps generated by
+       S\bSP\bPL\bLA\bAT\bT!\b! display elevations using a  logarithmic  grayscale,
+       with higher elevations represented through brighter shades
+       of gray.  The dynamic range of the image is scaled between
+       the highest and lowest elevations present in the map.  The
+       only exception to this is sea-level, which is  represented
+       using the color blue.
+
+       Topographic output is invoked using the _\b-_\bo switch:
+
+       splat -t tx_site -r rx_site -o topo_map.ppm
+
+       The  _\b._\bp_\bp_\bm  extension  on the output filename is assumed by
+       S\bSP\bPL\bLA\bAT\bT!\b!, and is optional.
+
+       In this example, _\bt_\bo_\bp_\bo_\b__\bm_\ba_\bp_\b._\bp_\bp_\bm will  illustrate  the  loca-
+       tions of the transmitter and receiver sites specified.  In
+       addition, the great circle path between the two sites will
+       be  drawn  over  locations  for which an unobstructed path
+       exists to the transmitter at a  receiving  antenna  height
+       equal   to   that  of  the  receiver  site  (specified  in
+       _\br_\bx_\b__\bs_\bi_\bt_\be_\b._\bq_\bt_\bh).
+
+       It may desirable to  populate  the  topographic  map  with
+       names  and  locations  of  cities,  tower  sites, or other
+       important locations.  A city file may be passed to  S\bSP\bPL\bLA\bAT\bT!\b!
+       using the _\b-_\bs switch:
+
+       splat -t tx_site -r rx_site -s cities.dat -o topo_map
+
+       Up  to five separate city files may be passed to S\bSP\bPL\bLA\bAT\bT!\b! at
+       a time following the _\b-_\bs switch.
+
+       County and state boundaries may be added  to  the  map  by
+       specifying  up  to  five  U.S.  Census Bureau cartographic
+       boundary files using the _\b-_\bb switch:
+
+       splat -t tx_site -r rx_site -b co34_d00.dat -o topo_map
+
+       In situations where multiple transmitter sites are in use,
+       as  many as four site locations may be passed to S\bSP\bPL\bLA\bAT\bT!\b! at
+       a time for analysis:
+
+       splat -t tx_site1 tx_site2 tx_site3 tx_site4 -r rx_site -p
+       profile.png
+
+       In  this  example,  four  separate  terrain  profiles  and
+       obstruction reports will be generated by S\bSP\bPL\bLA\bAT\bT!\b!.  A single
+       topographic  map can be specified using the _\b-_\bo switch, and
+       line-of-sight  paths  between  each  transmitter  and  the
+       receiver  site indicated will be produced on the map, each
+       in its own color.  The path between the first  transmitter
+       specified  to  the  receiver  will  be  in green, the path
+       between the second transmitter and the receiver will be in
+       cyan,  the  path  between  the  third  transmitter and the
+       receiver will be in  violet,  and  the  path  between  the
+       fourth transmitter and the receiver will be in sienna.
+
+       S\bSP\bPL\bLA\bAT\bT!\b!  generated  topographic  maps  are 24-bit TrueColor
+       Portable PixMap (PPM) images.  They may be viewed, edited,
+       or  converted  to  other  graphic formats by popular image
+       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,
+       and X\bXP\bPa\bai\bin\bnt\bt.  PNG format is highly recommended for lossless
+       compressed storage of S\bSP\bPL\bLA\bAT\bT!\b!  generated topographic output
+       files.  I\bIm\bma\bag\bge\beM\bMa\bag\bgi\bic\bck\bk's command-line utility easily converts
+       S\bSP\bPL\bLA\bAT\bT!\b!'s PPM files to PNG format:
+
+       convert splat_map.ppm splat_map.png
+
+       Another excellent  PPM  to  PNG  command-line  utility  is
+       available                                              at:
+       _\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
+       last  resort,  PPM files may be compressed using the bzip2
+       utility, and read directly by T\bTh\bhe\be G\bGI\bIM\bMP\bP in this format.
+
+       The _\b-_\bn_\bg_\bs 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:
+
+       splat -t  tx_site  -r  rx_site  -b  co34_d00.dat  -ngs  -o
+       white_map
+
+       The  resulting  .ppm  image  file can be converted to .png
+       format with a transparent background  using  I\bIm\bma\bag\bge\beM\bMa\bag\bgi\bic\bck\bk's
+       c\bco\bon\bnv\bve\ber\brt\bt utility:
+
+       convert  -transparent  "#FFFFFF"  white_map.ppm  transpar-
+       ent_map.png
+
+R\bRE\bEG\bGI\bIO\bON\bNA\bAL\bL C\bCO\bOV\bVE\bER\bRA\bAG\bGE\bE A\bAN\bNA\bAL\bLY\bYS\bSI\bIS\bS
+       S\bSP\bPL\bLA\bAT\bT!\b! can analyze a transmitter or repeater site, or net-
+       work  of sites, and predict the regional coverage for each
+       site specified.  In this mode, S\bSP\bPL\bLA\bAT\bT!\b! can generate a topo-
+       graphic  map displaying the geometric line-of-sight cover-
+       age area of the sites based on the location of  each  site
+       and  the  height of receive antenna wishing to communicate
+       with the site in question.  A  regional  analysis  may  be
+       performed by S\bSP\bPL\bLA\bAT\bT!\b! using the _\b-_\bc switch as follows:
+
+       splat  -t tx_site -c 30.0 -s cities.dat -b co34_d00.dat -o
+       tx_coverage
+
+       In this example, S\bSP\bPL\bLA\bAT\bT!\b! generates a topographic map called
+       _\bt_\bx_\b__\bc_\bo_\bv_\be_\br_\ba_\bg_\be_\b._\bp_\bp_\bm  that  illustrates  the predicted line-of-
+       sight regional coverage of _\bt_\bx_\b__\bs_\bi_\bt_\be to receiving  locations
+       having  antennas  30.0  feet above ground level (AGL).  If
+       the _\b-_\bm_\be_\bt_\br_\bi_\bc switch is used, the argument following the  _\b-_\bc
+       switch  is  interpreted  as being in meters rather than in
+       feet.  The contents of _\bc_\bi_\bt_\bi_\be_\bs_\b._\bd_\ba_\bt are plotted on the  map,
+       as  are  the cartographic boundaries contained in the file
+       _\bc_\bo_\b3_\b4_\b__\bd_\b0_\b0_\b._\bd_\ba_\bt.
+
+       When plotting line-of-sight paths and  areas  of  regional
+       coverage,  S\bSP\bPL\bLA\bAT\bT!\b!  by  default  does  not  account for the
+       effects of atmospheric bending.   However,  this  behavior
+       may  be modified by using the Earth radius multiplier (_\b-_\bm)
+       switch:
+
+       splat -t wnjt-dt -c 30.0 -m 1.333 -s cities.dat  -b  coun-
+       ties.dat -o map.ppm
+
+       An  earth  radius  multiplier of 1.333 instructs S\bSP\bPL\bLA\bAT\bT!\b! to
+       use the "four-thirds earth" model for line-of-sight propa-
+       gation  analysis.  Any appropriate earth radius multiplier
+       may be selected by the user.
+
+       When performing a regional analysis,  S\bSP\bPL\bLA\bAT\bT!\b!  generates  a
+       site  report  for  each  station  analyzed.   S\bSP\bPL\bLA\bAT\bT!\b!  site
+       reports contain details of the site's geographic location,
+       its  height  above  mean  sea  level, the antenna's height
+       above mean sea level, the antenna's height  above  average
+       terrain,  and the height of the average terrain calculated
+       toward the bearings of 0, 45, 90, 135, 180, 225, 270,  and
+       315 degrees azimuth.
+
+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 L\bLO\bOS\bS C\bCO\bOV\bVE\bER\bRA\bAG\bGE\bE
+       S\bSP\bPL\bLA\bAT\bT!\b!  can  also display line-of-sight coverage areas for
+       as many as four separate transmitter  sites  on  a  common
+       topographic map.  For example:
+
+       splat  -t  site1 site2 site3 site4 -c 10.0 -metric -o net-
+       work.ppm
+
+       plots the regional line-of-sight coverage of site1, site2,
+       site3,  and  site4 based on a receive antenna located 10.0
+       meters above ground level.   A  topographic  map  is  then
+       written to the file _\bn_\be_\bt_\bw_\bo_\br_\bk_\b._\bp_\bp_\bm.  The line-of-sight cover-
+       age area of the transmitters are plotted as follows in the
+       colors  indicated (along with their corresponding RGB val-
+       ues in decimal):
+
+           site1: Green (0,255,0)
+           site2: Cyan (0,255,255)
+           site3: Medium Violet (147,112,219)
+           site4: Sienna 1 (255,130,71)
+
+           site1 + site2: Yellow (255,255,0)
+           site1 + site3: Pink (255,192,203)
+           site1 + site4: Green Yellow (173,255,47)
+           site2 + site3: Orange (255,165,0)
+           site2 + site4: Dark Sea Green 1 (193,255,193)
+           site3 + site4: Dark Turquoise (0,206,209)
+
+           site1 + site2 + site3: Dark Green (0,100,0)
+           site1 + site2 + site4: Blanched Almond (255,235,205)
+           site1 + site3 + site4: Medium Spring Green (0,250,154)
+           site2 + site3 + site4: Tan (210,180,140)
+
+           site1 + site2 + site3 + site4: Gold2 (238,201,0)
+
+       If  separate _\b._\bq_\bt_\bh files are generated, each representing a
+       common site location but a  different  antenna  height,  a
+       single  topographic map illustrating the regional coverage
+       from as many as four separate locations on a single  tower
+       may be generated by S\bSP\bPL\bLA\bAT\bT!\b!.
+
+L\bLO\bON\bNG\bGL\bLE\bEY\bY-\b-R\bRI\bIC\bCE\bE P\bPA\bAT\bTH\bH L\bLO\bOS\bSS\bS A\bAN\bNA\bAL\bLY\bYS\bSI\bIS\bS
+       If  the  _\b-_\bc  switch is replaced by a _\b-_\bL switch, a Longley-
+       Rice path loss map for a transmitter site  may  be  gener-
+       ated:
+
+       splat  -t  wnjt  -L  30.0 -s cities.dat -b co34_d00.dat -o
+       path_loss_map
+
+       In this mode, S\bSP\bPL\bLA\bAT\bT!\b! generates a  multi-color  map  illus-
+       trating  expected  signal  levels in areas surrounding the
+       transmitter site.  A legend at the bottom of the map  cor-
+       relates  each  color  with  a  specific path loss range in
+       decibels or signal strength in decibels over one microvolt
+       per meter (dBuV/m).
+
+       The Longley-Rice analysis range may be modified to a user-
+       specific value using the _\b-_\bR switch.  The argument must  be
+       given  in  miles  (or  kilometers if the _\b-_\bm_\be_\bt_\br_\bi_\bc switch is
+       used).  If a range wider than  the  generated  topographic
+       map  is  specified,  S\bSP\bPL\bLA\bAT\bT!\b! will perform Longley-Rice path
+       loss calculations between all four  corners  of  the  area
+       prediction map.
+
+       The  _\b-_\bd_\bb  switch  allows  a constraint to be placed on the
+       maximum path loss region plotted on the  map.   A  maximum
+       path  loss  between  80  and 230 dB may be specified using
+       this switch.  For example, if a path loss beyond  -140  dB
+       is irrelevant to the survey being conducted, S\bSP\bPL\bLA\bAT\bT!\b!'s path
+       loss plot can be constrained to the region bounded by  the
+       140 dB attenuation contour as follows:
+
+       splat -t wnjt-dt -L 30.0 -s cities.dat -b co34_d00.dat -db
+       140 -o plot.ppm
+
+
+S\bSI\bIG\bGN\bNA\bAL\bL C\bCO\bON\bNT\bTO\bOU\bUR\bR C\bCO\bOL\bLO\bOR\bR D\bDE\bEF\bFI\bIN\bNI\bIT\bTI\bIO\bON\bN P\bPA\bAR\bRA\bAM\bME\bET\bTE\bER\bRS\bS
+       The colors used to illustrate  signal  strength  and  path
+       loss  contours  in  S\bSP\bPL\bLA\bAT\bT!\b!  generated coverage maps may be
+       tailored by the user by  creating  or  modifying  S\bSP\bPL\bLA\bAT\bT!\b!'s
+       color  definition  files.   S\bSP\bPL\bLA\bAT\bT!\b!  color definition files
+       have the same base name as the  transmitter's  _\b._\bq_\bt_\bh  file,
+       but carry _\b._\bl_\bc_\bf and _\b._\bs_\bc_\bf extensions.
+
+       When a regional Longley-Rice analysis is performed and the
+       transmitter's ERP is not specified or is zero, a _\b._\bl_\bc_\bf path
+       loss  color definition file corresponding to the transmit-
+       ter site (_\b._\bq_\bt_\bh) is read by S\bSP\bPL\bLA\bAT\bT!\b! from the current working
+       directory.   If a _\b._\bl_\bc_\bf file corresponding to the transmit-
+       ter site is not found, then a default  file  suitable  for
+       manual  editing  by the user is automatically generated by
+       S\bSP\bPL\bLA\bAT\bT!\b!.  If the transmitter's ERP  is  specified,  then  a
+       signal  strength  map  is  generated and a signal strength
+       color definition file (_\b._\bs_\bc_\bf) is read, or generated if  one
+       is not available in the current working directory.
+
+       A  path-loss color definition file possesses the following
+       structure (_\bw_\bn_\bj_\bt_\b-_\bd_\bt_\b._\bl_\bc_\bf):
+
+        ;  SPLAT!  Auto-generated  Path-Loss   Color   Definition
+       ("wnjt-dt.lcf") File
+        ;
+        ;  Format for the parameters held in this file is as fol-
+       lows:
+        ;
+        ;    dB: red, green, blue
+        ;
+        ; ...where "dB" is the path loss (in dB) 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.
+        ;
+        ;
+         80: 255,   0,   0
+         90: 255, 128,   0
+        100: 255, 165,   0
+        110: 255, 206,   0
+        120: 255, 255,   0
+        130: 184, 255,   0
+        140:   0, 255,   0
+        150:   0, 208,   0
+        160:   0, 196, 196
+        170:   0, 148, 255
+        180:  80,  80, 255
+        190:   0,  38, 255
+        200: 142,  63, 255
+        210: 196,  54, 255
+        220: 255,   0, 255
+        230: 255, 194, 204
+
+
+       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 contour.
+
+       S\bSP\bPL\bLA\bAT\bT!\b! signal strength color definition files share a very
+       similar structure (_\bw_\bn_\bj_\bt_\b-_\bd_\bt_\b._\bs_\bc_\bf):
+
+        ;  SPLAT!  Auto-generated Signal Color Definition ("wnjt-
+       dt.scf") File
+        ;
+        ; Format for the parameters held in this file is as  fol-
+       lows:
+        ;
+        ;    dBuV/m: red, green, blue
+        ;
+        ;  ...where  "dBuV/m"  is the signal strength (in dBuV/m)
+       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.
+        ;
+        ;
+        128: 255,   0,   0
+        118: 255, 165,   0
+        108: 255, 206,   0
+         98: 255, 255,   0
+         88: 184, 255,   0
+         78:   0, 255,   0
+         68:   0, 208,   0
+         58:   0, 196, 196
+         48:   0, 148, 255
+         38:  80,  80, 255
+         28:   0,  38, 255
+         18: 142,  63, 255
+          8: 140,   0, 128
+
+
+       If  the signal strength is greater than or equal to 128 db
+       over 1 microvolt per meter (dBuV/m), the color  Red  (255,
+       0, 0) is displayed for the region.  If the signal strength
+       is greater than or equal to 118 dbuV/m, but less than  128
+       dbuV/m,  then the color Orange (255, 165, 0) is displayed,
+       and so on.  Greyscale terrain  is  displayed  for  regions
+       with signal strengths less than 8 dBuV/m.
+
+       Signal  strength  contours  for  some  common  VHF and UHF
+       broadcasting services in the United States are as follows:
+
+              Analog Television Broadcasting
+              ------------------------------
+              Channels 2-6:       City Grade: >= 74 dBuV/m
+                                     Grade A: >= 68 dBuV/m
+                                     Grade B: >= 47 dBuV/m
+              --------------------------------------------
+              Channels 7-13:      City Grade: >= 77 dBuV/m
+                                     Grade A: >= 71 dBuV/m
+                                     Grade B: >= 56 dBuV/m
+              --------------------------------------------
+              Channels 14-69:   Indoor Grade: >= 94 dBuV/m
+                                  City Grade: >= 80 dBuV/m
+                                     Grade A: >= 74 dBuV/m
+                                     Grade B: >= 64 dBuV/m
+
+              Digital Television Broadcasting
+              -------------------------------
+              Channels 2-6:       City Grade: >= 35 dBuV/m
+                           Service Threshold: >= 28 dBuV/m
+              --------------------------------------------
+              Channels 7-13:      City Grade: >= 43 dBuV/m
+                           Service Threshold: >= 36 dBuV/m
+              --------------------------------------------
+              Channels 14-69:     City Grade: >= 48 dBuV/m
+                           Service Threshold: >= 41 dBuV/m
+
+              NOAA Weather Radio (162.400 - 162.550 MHz)
+              ------------------------------------------
+                         Reliable: >= 18 dBuV/m
+                     Not reliable: <  18 dBuV/m
+              Unlikely to receive: <  0 dBuV/m
+
+              FM Radio Broadcasting (88.1 - 107.9 MHz)
+              ----------------------------------------
+              Analog Service Contour:  60 dBuV/m
+              Digital Service Contour: 65 dBuV/m
+
+
+
+A\bAN\bNT\bTE\bEN\bNN\bNA\bA R\bRA\bAD\bDI\bIA\bAT\bTI\bIO\bON\bN P\bPA\bAT\bTT\bTE\bER\bRN\bN P\bPA\bAR\bRA\bAM\bME\bET\bTE\bER\bRS\bS
+       Normalized  field  voltage  patterns  for  a  transmitting
+       antenna's horizontal  and  vertical  planes  are  imported
+       automatically  into  S\bSP\bPL\bLA\bAT\bT!\b!  when  a Longley-Rice coverage
+       analysis is performed.  Antenna pattern data is read  from
+       a pair of files having the same base name as the transmit-
+       ter and LRP files, but with _\b._\ba_\bz  and  _\b._\be_\bl  extensions  for
+       azimuth and elevation pattern files, respectively.  Speci-
+       fications regarding pattern rotation (if any) and mechani-
+       cal  beam  tilt  and tilt direction (if any) are also con-
+       tained within S\bSP\bPL\bLA\bAT\bT!\b! antenna pattern files.
+
+       For example, the first few lines of a S\bSP\bPL\bLA\bAT\bT!\b! azimuth  pat-
+       tern file might appear as follows (_\bk_\bv_\be_\ba_\b._\ba_\bz):
+
+               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 _\b._\ba_\bz file specifies the amount of
+       azimuthal pattern rotation (measured clockwise in  degrees
+       from  True North) to be applied by S\bSP\bPL\bLA\bAT\bT!\b! to the data con-
+       tained in the _\b._\ba_\bz file.  This is followed by azimuth head-
+       ings  (0  to  360 degrees) and their associated normalized
+       field patterns (0.000 to 1.000) separated by whitespace.
+
+       The  structure  of  S\bSP\bPL\bLA\bAT\bT!\b!  elevation  pattern  files   is
+       slightly different.  The first line of the _\b._\be_\bl file speci-
+       fies the amount of mechanical beam  tilt  applied  to  the
+       antenna.  Note that a _\bd_\bo_\bw_\bn_\bw_\ba_\br_\bd _\bt_\bi_\bl_\bt (below the horizon) is
+       expressed as a _\bp_\bo_\bs_\bi_\bt_\bi_\bv_\be _\ba_\bn_\bg_\bl_\be, while an _\bu_\bp_\bw_\ba_\br_\bd _\bt_\bi_\bl_\bt (above
+       the  horizon) is expressed as a _\bn_\be_\bg_\ba_\bt_\bi_\bv_\be _\ba_\bn_\bg_\bl_\be.  This data
+       is followed by the azimuthal direction of the tilt,  sepa-
+       rated by whitespace.
+
+       The remainder of the file consists of elevation angles and
+       their corresponding normalized voltage  radiation  pattern
+       (0.000  to  1.000) values separated by whitespace.  Eleva-
+       tion angles must be specified over a -10.0 to +90.0 degree
+       range.   As  was  the convention with mechanical beamtilt,
+       _\bn_\be_\bg_\ba_\bt_\bi_\bv_\be _\be_\bl_\be_\bv_\ba_\bt_\bi_\bo_\bn _\ba_\bn_\bg_\bl_\be_\bs are used to represent elevations
+       _\ba_\bb_\bo_\bv_\be _\bt_\bh_\be _\bh_\bo_\br_\bi_\bz_\bo_\bn, while _\bp_\bo_\bs_\bi_\bt_\bi_\bv_\be _\ba_\bn_\bg_\bl_\be_\bs represents eleva-
+       tions _\bb_\be_\bl_\bo_\bw _\bt_\bh_\be _\bh_\bo_\br_\bi_\bz_\bo_\bn.
+
+       For example, the first few lines a S\bSP\bPL\bLA\bAT\bT!\b!  elevation  pat-
+       tern file might appear as follows (_\bk_\bv_\be_\ba_\b._\be_\bl):
+
+               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
+
+       In  this example, the antenna is mechanically tilted down-
+       ward 1.1 degrees towards an azimuth of 130.0 degrees.
+
+       For best results, the resolution of azimuth  pattern  data
+       should  be  specified  to  the nearest degree azimuth, and
+       elevation pattern data resolution should be  specified  to
+       the  nearest  0.01 degrees.  If the pattern data specified
+       does not reach  this  level  of  resolution,  S\bSP\bPL\bLA\bAT\bT!\b!  will
+       interpolate  the  values provided to determine the data at
+       the required resolution, although this  may  result  in  a
+       loss in accuracy.
+
+
+I\bIM\bMP\bPO\bOR\bRT\bTI\bIN\bNG\bG A\bAN\bND\bD E\bEX\bXP\bPO\bOR\bRT\bTI\bIN\bNG\bG R\bRE\bEG\bGI\bIO\bON\bNA\bAL\bL P\bPA\bAT\bTH\bH L\bLO\bOS\bSS\bS C\bCO\bON\bNT\bTO\bOU\bUR\bR D\bDA\bAT\bTA\bA
+       Performing  a Longley-Rice coverage analysis can be a very
+       time consuming process,  especially  if  the  analysis  is
+       repeated  repeatedly  to  discover what effects changes to
+       the antenna radiation patterns make to the predicted  cov-
+       erage area.
+
+       This  process  can  be expedited by exporting the Longley-
+       Rice regional path loss contour data to  an  output  file,
+       modifying  the  path  loss  data externally to incorporate
+       antenna pattern effects, and then importing  the  modified
+       path  loss  data  back  into  S\bSP\bPL\bLA\bAT\bT!\b!  to rapidly produce a
+       revised path loss map.
+
+       For example, a path loss output file can be  generated  by
+       S\bSP\bPL\bLA\bAT\bT!\b!  for a receive site 30 feet above ground level over
+       a 50 mile radius surrounding a transmitter site to a maxi-
+       mum path loss of 140 dB using the following syntax:
+
+       splat -t kvea -L 30.0 -R 50.0 -db 140 -plo pathloss.dat
+
+       S\bSP\bPL\bLA\bAT\bT!\b!  path  loss output files often exceed 100 megabytes
+       in size.  They contain information relating to the  bound-
+       aries  of  region  they  describe  followed  by  latitudes
+       (degrees North), longitudes (degrees West), azimuths, ele-
+       vations  (to the first obstruction), and path loss figures
+       (dB) for a series of specific  points  that  comprise  the
+       region  surrounding  the  transmitter site.  The first few
+       lines of a S\bSP\bPL\bLA\bAT\bT!\b! path loss output file take on  the  fol-
+       lowing appearance (_\bp_\ba_\bt_\bh_\bl_\bo_\bs_\bs_\b._\bd_\ba_\bt):
+
+               119, 117    ; max_west, min_west
+               35, 33      ; max_north, min_north
+               34.2265434, 118.0631104, 48.171, -37.461, 67.70
+               34.2270355, 118.0624390, 48.262, -26.212, 73.72
+               34.2280197, 118.0611038, 48.269, -14.951, 79.74
+               34.2285156, 118.0604401, 48.207, -11.351, 81.68
+               34.2290077, 118.0597687, 48.240, -10.518, 83.26
+               34.2294998, 118.0591049, 48.225, 23.201, 84.60
+               34.2304878, 118.0577698, 48.213, 15.769, 137.84
+               34.2309799, 118.0570984, 48.234, 15.965, 151.54
+               34.2314720, 118.0564346, 48.224, 16.520, 149.45
+               34.2319679, 118.0557632, 48.223, 15.588, 151.61
+               34.2329521, 118.0544281, 48.230, 13.889, 135.45
+               34.2334442, 118.0537643, 48.223, 11.693, 137.37
+               34.2339401, 118.0530930, 48.222, 14.050, 126.32
+               34.2344322, 118.0524292, 48.216, 16.274, 156.28
+               34.2354164, 118.0510941, 48.222, 15.058, 152.65
+               34.2359123, 118.0504227, 48.221, 16.215, 158.57
+               34.2364044, 118.0497589, 48.216, 15.024, 157.30
+               34.2368965, 118.0490875, 48.225, 17.184, 156.36
+
+       It  is  not uncommon for S\bSP\bPL\bLA\bAT\bT!\b! path loss files to contain
+       as many as 3 million or more lines of data.  Comments  can
+       be placed in the file if they are proceeded by a semicolon
+       character.  The v\bvi\bim\bm text  editor  has  proven  capable  of
+       editing files of this size.
+
+       Note  as  was the case in the antenna pattern files, nega-
+       tive 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 _\b-_\bL switch _\bi_\bf the path  between  trans-
+       mitter  and receiver is unobstructed.  If the path between
+       the transmitter and receiver is obstructed, then the  ele-
+       vation  angle  to  the  first  obstruction  is returned by
+       S\bSP\bPL\bLA\bAT\bT!\b!.  This is because the Longley-Rice model  considers
+       the  energy  reaching  a  distant point over an obstructed
+       path as a derivative of the energy scattered from the  top
+       of the first obstruction, only.  Since energy cannot reach
+       the obstructed location  directly,  the  actual  elevation
+       angle to that point is irrelevant.
+
+       When  modifying  S\bSP\bPL\bLA\bAT\bT!\b! path loss files to reflect antenna
+       pattern data, _\bo_\bn_\bl_\by _\bt_\bh_\be _\bl_\ba_\bs_\bt _\bc_\bo_\bl_\bu_\bm_\bn _\b(_\bp_\ba_\bt_\bh _\bl_\bo_\bs_\bs_\b)  should  be
+       amended  to  reflect  the antenna's normalized gain at the
+       azimuth and elevation angles specified in the  file.   (At
+       this time, programs and scripts capable of performing this
+       operation are left as an exercise for the user.)
+
+       Modified path loss maps can be imported back  into  S\bSP\bPL\bLA\bAT\bT!\b!
+       for generating revised coverage maps:
+
+       splat  -t kvea -pli pathloss.dat -s city.dat -b county.dat
+       -o map.ppm
+
+       S\bSP\bPL\bLA\bAT\bT!\b! path loss files can also  be  used  for  conducting
+       coverage or interference studies outside of S\bSP\bPL\bLA\bAT\bT!\b!.
+
+U\bUS\bSE\bER\bR-\b-D\bDE\bEF\bFI\bIN\bNE\bED\bD T\bTE\bER\bRR\bRA\bAI\bIN\bN I\bIN\bNP\bPU\bUT\bT F\bFI\bIL\bLE\bES\bS
+       A  user-defined terrain file is a user-generated text file
+       containing latitudes, longitudes, and heights above ground
+       level  of  specific  terrain  features  believed  to be of
+       importance to the S\bSP\bPL\bLA\bAT\bT!\b!  analysis  being  conducted,  but
+       noticeably  absent from the SDF files being used.  A user-
+       defined terrain file is imported into  a  S\bSP\bPL\bLA\bAT\bT!\b!  analysis
+       using the _\b-_\bu_\bd_\bt switch:
+
+        splat -t tx_site -r rx_site -udt udt_file.txt -o map.ppm
+
+       A  user-defined  terrain file has the following appearance
+       and structure:
+
+              40.32180556, 74.1325, 100.0 meters
+              40.321805, 74.1315, 300.0
+              40.3218055, 74.1305, 100.0 meters
+
+       Terrain height is interpreted as being described  in  feet
+       above ground level unless followed by the word _\bm_\be_\bt_\be_\br_\bs, and
+       is added _\bo_\bn _\bt_\bo_\bp _\bo_\bf the terrain specified in the  SDF  data
+       for  the  locations  specified.   Be aware that each user-
+       defined terrain feature specified will be  interpreted  as
+       being  3-arc seconds in both latitude and longitude.  Fea-
+       tures described in  the  user-defined  terrain  file  that
+       overlap  previously  defined  features  in  the  file  are
+       ignored by S\bSP\bPL\bLA\bAT\bT!\b!.
+
+S\bSI\bIM\bMP\bPL\bLE\bE 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
+       In certain situations it may be desirable  to  generate  a
+       topographic  map  of  a  region  without plotting coverage
+       areas,  line-of-sight  paths,  or  generating  obstruction
+       reports.   There  are  several ways of doing this.  If one
+       wishes to generate  a  topographic  map  illustrating  the
+       location  of  a transmitter and receiver site along with a
+       brief text report describing the locations  and  distances
+       between the sites, the _\b-_\bn switch should be invoked as fol-
+       lows:
+
+       splat -t tx_site -r rx_site -n -o topo_map.ppm
+
+       If no text report is desired, then the _\b-_\bN switch is used:
+
+       splat -t tx_site -r rx_site -N -o topo_map.ppm
+
+       If a topographic map centered about a single site out to a
+       minimum  specified  radius  is  desired instead, a command
+       similar to the following can be used:
+
+       splat -t tx_site -R 50.0 -s NJ_Cities  -b  NJ_Counties  -o
+       topo_map.ppm
+
+       where  -R specifies the minimum radius of the map in miles
+       (or kilometers if the _\b-_\bm_\be_\bt_\br_\bi_\bc switch is used).  Note  that
+       the  tx_site  name  and location are not displayed in this
+       example.  If display of this information is desired,  sim-
+       ply create a S\bSP\bPL\bLA\bAT\bT!\b! city file (_\b-_\bs option) and append it to
+       the list of command-line options illustrated above.
+
+       If the _\b-_\bo switch and output filename are omitted in  these
+       operations,  topographic output is written to a file named
+       _\bt_\bx_\b__\bs_\bi_\bt_\be_\b._\bp_\bp_\bm in the current working directory by default.
+
+G\bGE\bEO\bOR\bRE\bEF\bFE\bER\bRE\bEN\bNC\bCE\bE F\bFI\bIL\bLE\bE G\bGE\bEN\bNE\bER\bRA\bAT\bTI\bIO\bON\bN
+       Topographic, coverage (_\b-_\bc), and  path  loss  contour  (_\b-_\bL)
+       maps  generated  by  S\bSP\bPL\bLA\bAT\bT!\b! may be imported into X\bXa\bas\bst\bti\bir\br (X
+       Amateur Station Tracking and Information Reporting)  soft-
+       ware by generating a georeference file using S\bSP\bPL\bLA\bAT\bT!\b!'s _\b-_\bg_\be_\bo
+       switch:
+
+       splat -t kd2bd -R 50.0 -s NJ_Cities -b NJ_Counties -geo -o
+       map.ppm
+
+       The  georeference  file  generated will have the same base
+       name as the _\b-_\bo file specified, but have a  _\b._\bg_\be_\bo extension,
+       and  permit  proper interpretation and display of S\bSP\bPL\bLA\bAT\bT!\b!'s
+       .ppm graphics in X\bXa\bas\bst\bti\bir\br software.
+
+G\bGO\bOO\bOG\bGL\bLE\bE M\bMA\bAP\bP K\bKM\bML\bL F\bFI\bIL\bLE\bE G\bGE\bEN\bNE\bER\bRA\bAT\bTI\bIO\bON\bN
+       Keyhole Markup Language files compatible with G\bGo\boo\bog\bgl\ble\be E\bEa\bar\brt\bth\bh
+       may  be generated by S\bSP\bPL\bLA\bAT\bT!\b! when performing point-to-point
+       or regional coverage analyses by invoking the _\b-_\bk_\bm_\bl switch:
+
+       splat -t wnjt-dt -r kd2bd -kml
+
+       The  KML file generated will have the same filename struc-
+       ture as a Path Analysis Report  for  the  transmitter  and
+       receiver  site  names  given, except it will carry a  _\b._\bk_\bm_\bl
+       extension.
+
+       Once loaded into G\bGo\boo\bog\bgl\ble\be E\bEa\bar\brt\bth\bh (File  -->  Open),  the  KML
+       file  will  annotate 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  dis-
+       played  in  green.   G\bGo\boo\bog\bgl\ble\be E\bEa\bar\brt\bth\bh's navigation tools allow
+       the user to "fly" around  the  path,  identify  landmarks,
+       roads, and other featured content.
+
+       When performing regional coverage analysis, the  _\b._\bk_\bm_\bl file
+       generated by  S\bSP\bPL\bLA\bAT\bT!\b!  will  permit  path  loss  or  signal
+       strength  contours  to be layered on top of G\bGo\boo\bog\bgl\ble\be E\bEa\bar\brt\bth\bh's
+       display in a semi-transparent manner.  The generated  _\b._\bk_\bm_\bl
+       file  will have the same basename as that of the _\b._\bp_\bp_\bm file
+       normally generated.
+
+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
+       S\bSP\bPL\bLA\bAT\bT!\b! determines antenna  height  above  average  terrain
+       (HAAT)  according to the procedure defined by Federal Com-
+       munications Commission Part 73.313(d).  According to  this
+       definition, terrain elevations along eight radials between
+       2 and 10 miles (3 and 16 kilometers) from the  site  being
+       analyzed  are  sampled and averaged for each 45 degrees of
+       azimuth starting with True North.  If one or more  radials
+       lie  entirely  over  water or over land outside the United
+       States (areas for which no USGS topography data is  avail-
+       able), then those radials are omitted from the calculation
+       of average terrain.
+
+       Note that SRTM elevation data, unlike older  3-arc  second
+       USGS  data,  extends  beyond  the  borders  of  the United
+       States.  Therefore, HAAT results may not be in  full  com-
+       pliance with FCC Part 73.313(d) in areas along the borders
+       of the United States if the SDF files used by  S\bSP\bPL\bLA\bAT\bT!\b!  are
+       SRTM-derived.
+
+       When  performing  point-to-point  terrain analysis, S\bSP\bPL\bLA\bAT\bT!\b!
+       determines the antenna height above average  terrain  only
+       if  enough topographic data has already been loaded by the
+       program to perform the point-to-point analysis.   In  most
+       cases, this will be true, unless the site in question does
+       not lie within 10 miles of the boundary of the  topography
+       data in memory.
+
+       When  performing area prediction analysis, enough topogra-
+       phy data is normally loaded by S\bSP\bPL\bLA\bAT\bT!\b! to  perform  average
+       terrain  calculations.  Under such conditions, S\bSP\bPL\bLA\bAT\bT!\b! will
+       provide the antenna height above average terrain  as  well
+       as  the  average terrain above mean sea level for azimuths
+       of 0, 45, 90, 135, 180, 225, 270,  and  315  degrees,  and
+       include such information in the generated site report.  If
+       one or more of the eight radials surveyed fall over water,
+       or over regions for which no SDF data is available, S\bSP\bPL\bLA\bAT\bT!\b!
+       reports _\bN_\bo _\bT_\be_\br_\br_\ba_\bi_\bn for the radial paths affected.
+
+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
+       S\bSP\bPL\bLA\bAT\bT!\b! reads SDF files as needed into a series  of  memory
+       "pages"  within the structure of the program.  Each "page"
+       holds one SDF file representing a one degree by one degree
+       region  of  terrain.   A _\b#_\bd_\be_\bf_\bi_\bn_\be _\bM_\bA_\bX_\bP_\bA_\bG_\bE_\bS statement in the
+       first several lines of _\bs_\bp_\bl_\ba_\bt_\b._\bc_\bp_\bp sets the  maximum  number
+       of "pages" available for holding topography data.  It also
+       sets the maximum size of the topographic maps generated by
+       S\bSP\bPL\bLA\bAT\bT!\b!.  MAXPAGES is set to 9 by default.  If S\bSP\bPL\bLA\bAT\bT!\b!  pro-
+       duces a segmentation fault on start-up with this  default,
+       it  is  an  indication  that not enough RAM and/or virtual
+       memory (swap space) is available to run  S\bSP\bPL\bLA\bAT\bT!\b!  with  the
+       number  of MAXPAGES specified.  In situations where avail-
+       able memory is low, MAXPAGES may be reduced to 4 with  the
+       understanding  that  this  will  greatly limit the maximum
+       region S\bSP\bPL\bLA\bAT\bT!\b! will be able to analyze.  If  118  megabytes
+       or  more  of  total memory (swap space plus RAM) is avail-
+       able, then MAXPAGES may be increased  to  16.   This  will
+       permit operation over a 4-degree by 4-degree region, which
+       is sufficient for single  antenna  heights  in  excess  of
+       10,000  feet  above mean sea level, or point-to-point dis-
+       tances of over 1000 miles.
+
+A\bAD\bDD\bDI\bIT\bTI\bIO\bON\bNA\bAL\bL I\bIN\bNF\bFO\bOR\bRM\bMA\bAT\bTI\bIO\bON\bN
+       The latest news and information regarding S\bSP\bPL\bLA\bAT\bT!\b!  software
+       is available through the official S\bSP\bPL\bLA\bAT\bT!\b! software web page
+       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.
+
+A\bAU\bUT\bTH\bHO\bOR\bRS\bS
+       John A. Magliacane, KD2BD <_\bk_\bd_\b2_\bb_\bd_\b@_\ba_\bm_\bs_\ba_\bt_\b._\bo_\br_\bg>
+              Creator, Lead Developer
+
+       Doug McDonald <_\bm_\bc_\bd_\bo_\bn_\ba_\bl_\bd_\b@_\bs_\bc_\bs_\b._\bu_\bi_\bu_\bc_\b._\be_\bd_\bu>
+              Original Longley-Rice Model integration
+
+       Ron Bentley <_\br_\bo_\bn_\bb_\be_\bn_\bt_\bl_\be_\by_\b@_\be_\ba_\br_\bt_\bh_\bl_\bi_\bn_\bk_\b._\bn_\be_\bt>
+              Fresnel Zone plotting and clearance determination
+
+
+
+
+KD2BD Software          16 September 2007               SPLAT!(1)