-SPLAT!(1) KD2BD Software SPLAT!(1)
+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
+ splat An RF S\bSignal P\bPropagation, L\bLoss, A\bAnd T\bTerrain analysis 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]
+ 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_\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_\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
+ _\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd _\bb_\be_\by_\bo_\bn_\bd _\bw_\bh_\bi_\bc_\bh _\bc_\bo_\bn_\bt_\bo_\bu_\br_\bs _\bw_\bi_\bl_\bl _\bn_\bo_\bt _\bb_\be _\bd_\bi_\bs_\bp_\bl_\ba_\by_\be_\bd] [-gc _\bg_\br_\bo_\bu_\bn_\bd
+ _\bc_\bl_\bu_\bt_\bt_\be_\br _\bh_\be_\bi_\bg_\bh_\bt _\b(_\bf_\be_\be_\bt_\b/_\bm_\be_\bt_\be_\br_\bs_\b) _\b(_\bf_\bl_\bo_\ba_\bt_\b)] [-fz _\bF_\br_\be_\bs_\bn_\be_\bl _\bz_\bo_\bn_\be _\bc_\bl_\be_\ba_\br_\ba_\bn_\bc_\be _\bp_\be_\br_\b-
+ _\bc_\be_\bn_\bt_\ba_\bg_\be _\b(_\bd_\be_\bf_\ba_\bu_\bl_\bt _\b= _\b6_\b0_\b)] [-ano _\ba_\bl_\bp_\bh_\ba_\bn_\bu_\bm_\be_\br_\bi_\bc _\bo_\bu_\bt_\bp_\bu_\bt _\bf_\bi_\bl_\be _\bn_\ba_\bm_\be] [-ani
+ _\ba_\bl_\bp_\bh_\ba_\bn_\bu_\bm_\be_\br_\bi_\bc _\bi_\bn_\bp_\bu_\bt _\bf_\bi_\bl_\be _\bn_\ba_\bm_\be] [-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] [-dbm] [-ngs] [-geo] [-kml] [-gpsav] [-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.
+ S\bSP\bPL\bLA\bAT\bT!\b! is a powerful terrestrial RF propagation and terrain analysis
+ tool for the spectrum between 20 MHz and 20 GHz. S\bSP\bPL\bLA\bAT\bT!\b! 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 S\bSP\bPL\bLA\bAT\bT!\b! source code in proprietary or
+ closed-source applications is a violation 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 warranty of MERCHANTABILITY or
+ FITNESS FOR A PARTICULAR PURPOSE. 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
-
+ Applications of S\bSP\bPL\bLA\bAT\bT!\b! 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.
+
+ S\bSP\bPL\bLA\bAT\bT!\b! provides RF site engineering data such as great circle distances
+ and bearings between sites, antenna elevation angles (uptilt), depres-
+ sion 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 per-
+ centage of the first Fresnel zone are also provided.
+
+ S\bSP\bPL\bLA\bAT\bT!\b! produces reports, graphs, and high resolution topographic maps
+ that depict line-of-sight paths, and regional path loss and signal
+ strength contours through which expected coverage areas of transmitters
+ and repeater systems can be obtained. When performing line-of-sight
+ and Longley-Rice analyses in situations where multiple transmitter or
+ repeater sites are employed, S\bSP\bPL\bLA\bAT\bT!\b! determines individual and mutual
+ areas of coverage within the network specified.
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!\b! 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
+ 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:
+ 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. Geo-
+ logical Survey Digital Elevation Models (DEMs) using the p\bpo\bos\bst\btd\bdo\bow\bwn\bnl\blo\boa\bad\bd
+ and u\bus\bsg\bgs\bs2\b2s\bsd\bdf\bf utilities included with S\bSP\bPL\bLA\bAT\bT!\b!. USGS Digital Elevation
+ Models compatible with these utilities 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.
+ Significantly better resolution and accuracy can be obtained through
+ the use of SRTM Version 2 digital elevation models, especially when
+ supplemented by USGS-derived SDF data. These one-degree by one-degree
+ models are the product of the Space Shuttle STS-99 Radar Topography
+ Mission, and are available for most populated regions of the Earth.
+ SPLAT Data Files may be generated from 3 arc-second SRTM-3 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_\b-
+ _\bs_\bi_\bo_\bn_\b2_\b/_\bS_\bR_\bT_\bM_\b3_\b/
+
+ 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 s\bsr\brt\btm\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_\b-
+ _\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 topo-
+ graphic data through the USGS's Seamless Web Site.
+
+ Even greater resolution and accuracy can be obtained by using 1 arc-
+ second SRTM-1 Version 2 topography data. This data is available for
+ the United States and its territories and possessions, and may be down-
+ loaded 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/_\bS_\bR_\bT_\bM_\b1_\b/
+
+ High resolution SDF files for use with S\bSP\bPL\bLA\bAT\bT!\b! H\bHD\bD may be generated from
+ data in this format using the s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf-\b-h\bhd\bd utility.
+
+ 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 and
+ s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf-\b-h\bhd\bd utilities replace them with corresponding data found in
+ u\bus\bsg\bgs\bs2\b2s\bsd\bdf\bf generated SDF files. 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 elevations in meters
+ referenced to mean sea level for 1-degree by 1-degree regions of the
+ Earth. SDF files can be read by S\bSP\bPL\bLA\bAT\bT!\b! in either standard format
+ (_\b._\bs_\bd_\bf) as generated directly by the u\bus\bsg\bgs\bs2\b2s\bsd\bdf\bf, s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf, and s\bsr\brt\btm\bm2\b2s\bsd\bdf\bf-\b-h\bhd\bd
+ utilities, or in bzip2 compressed format (_\b._\bs_\bd_\bf_\b._\bb_\bz_\b2). Since uncom-
+ pressed 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 compressed 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 Digi-
+ tal Elevation Model data. However, this behavior of S\bSP\bPL\bLA\bAT\bT!\b! under-
+ scores the importance 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:
+ 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 speci-
+ fied 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 information 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.
+ Each transmitter and receiver site analyzed by S\bSP\bPL\bLA\bAT\bT!\b! must be repre-
+ sented 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)
+ Longley-Rice parameter data files are required for S\bSP\bPL\bLA\bAT\bT!\b! to determine
+ RF path loss, field strength, or received signal power level 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 transmitter
+ site QTH file, but with a _\b._\bl_\br_\bp extension. S\bSP\bPL\bLA\bAT\bT!\b! LRP files share the
+ following format (_\bw_\bn_\bj_\bt_\b-_\bd_\bt_\b._\bl_\br_\bp):
+
+ 15.000 ; Earth Dielectric Constant (Relative permittivity)
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)
+ 5 ; Radio Climate (5 = Continental Temperate)
+ 0 ; Polarization (0 = Horizontal, 1 = Vertical)
+ 0.50 ; Fraction of situations (50% of locations)
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.
+ If an LRP file corresponding to the tx_site QTH file cannot 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 directory. The gen-
+ erated "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
+ Typical Earth dielectric constants and conductivity values are as fol-
+ lows:
+ Dielectric Constant Conductivity
Salt water : 80 5.000
Good ground : 25 0.020
Fresh water : 80 0.010
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)
+ 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.
+ 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 Temper-
+ ate climates.
+
+ The seventh and eighth parameters in the _\b._\bl_\br_\bp file correspond to the
+ statistical analysis provided by the Longley-Rice model. In this exam-
+ ple, S\bSP\bPL\bLA\bAT\bT!\b! 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.
+
+ For further information on these parameters, see: _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bf_\bl_\ba_\bt_\b-
+ _\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_\b-
+ _\bn_\be_\be_\br_\bi_\bn_\bg_\b/_\bp_\br_\bo_\bp_\b__\bl_\bo_\bn_\bg_\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
+ _\b._\bl_\br_\bp file, then S\bSP\bPL\bLA\bAT\bT!\b! will compute received signal strength levels and
+ field strength level contours when performing Longley-Rice studies. If
+ the parameter is omitted, path loss is computed instead. The ERP pro-
+ vided in the _\b._\bl_\br_\bp file can be overridden by using S\bSP\bPL\bLA\bAT\bT!\b!'s _\b-_\be_\br_\bp com-
+ mand-line switch. If the _\b._\bl_\br_\bp file contains an ERP parameter and the
+ generation of path loss rather than field strength contours is desired,
+ the ERP can be assigned to zero using the _\b-_\be_\br_\bp switch without having 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.
+ The names and locations of cities, tower sites, or other points of
+ interest may be imported and plotted on topographic 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 longi-
+ tude. Each field is separated by a comma. Each record is separated 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):
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
+ 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 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 S\bSP\bPL\bLA\bAT\bT!\b! generated 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
+ further 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\bec\bco\bod\bde\ber\br utility included with S\bSP\bPL\bLA\bAT\bT!\b!.
+ Such data is available free of charge via the Internet at:
+ _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bc_\be_\bn_\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.
+ Cartographic boundary data may also be imported to plot the boundaries
+ of cities, counties, or states on topographic 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 carto-
+ graphic 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.
+ 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) operations. S\bSP\bPL\bLA\bAT\bT!\b!'s CPU and memory scheduling prior-
+ ity 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 generation. 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.
+
+ Simply typing splat on the command line will return a summary of
+ S\bSP\bPL\bLA\bAT\bT!\b!'s command line options:
+
+ --==[ SPLAT! v1.3.0 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 path loss 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/kilometers)
+ -db threshold beyond which contours will not be displayed
+ -nf do not plot Fresnel zones in height plots
+ -fz Fresnel zone clearance percentage (default = 60)
+ -gc ground clutter height (feet/meters)
+ -ngs display greyscale topography as white in .ppm files
+ -erp override ERP in .lrp file (Watts)
+ -ano name of alphanumeric output file
+ -ani name of alphanumeric input 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)
+ -dbm plot signal power level contours rather than field strength
+ -gpsav preserve gnuplot temporary working files after SPLAT! execution
+ -metric employ metric rather than imperial units for all user I/O
+
+ The command-line options for splat and splat-hd are identical.
+
+ 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 Irregu-
+ lar Terrain (ITM) propagation model may be invoked by the user. True
+ Earth, four-thirds Earth, or any other user-defined Earth radius may be
+ specified 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:
+ S\bSP\bPL\bLA\bAT\bT!\b! may be used to perform line-of-sight terrain analysis 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:
+ invokes a line-of-sight terrain analysis between the transmitter speci-
+ fied in _\bt_\bx_\b__\bs_\bi_\bt_\be_\b._\bq_\bt_\bh and receiver specified 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 working directory. The report contains details of the trans-
+ mitter and receiver sites, and identifies the location of any obstruc-
+ tions 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
+ 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 example, 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:
+ _\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! auto-
+ matically 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:
+ 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:
+ 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.
+ S\bSP\bPL\bLA\bAT\bT!\b! invokes g\bgn\bnu\bup\bpl\blo\bot\bt when generating graphs. The filename 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 documentation 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:
+ A graph of elevations subtended by the terrain between the receiver and
+ transmitter as a function of distance from the receiver can be gener-
+ ated 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:
+ 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.
+
+ 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:
+ 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
+ splat -t tx_site -r rx_site -H normalized_height_profile.png
- A contour of the Earth's curvature is also plotted in this
- mode.
+ 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:
+ 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 fre-
+ quency (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
+ splat -t tx_site -r rx_site -f 439.250 -H normalized_height_profile.png
- Fresnel Zone clearances other 60% can be specified using
- the _\b-_\bf_\bz switch as follows:
+ 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
+ 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:
+ 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:
+ As before, adding the _\b-_\bm_\be_\bt_\br_\bi_\bc switch forces the graphs to be plotted
+ using metric units of measure. The _\b-_\bg_\bp_\bs_\ba_\bv switch instructs S\bSP\bPL\bLA\bAT\bT!\b! to
+ preserve (rather than delete) the g\bgn\bnu\bup\bpl\blo\bot\bt working files generated dur-
+ ing S\bSP\bPL\bLA\bAT\bT!\b! execution, allowing the user to edit these files and re-run
+ g\bgn\bnu\bup\bpl\blo\bot\bt if desired.
+
+ 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 bearings 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 correspond-
+ ing _\b._\bl_\br_\bp file, then predicted signal strength and antenna voltage at
+ the receiving 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 primary limiting factor in recep-
+ tion:
_\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.
+ where T\bT is the ERP of the transmitter in dBW in the direction 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 provided 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).
+ 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 horizon).
- To compute how much more signal is available over the min-
- imum to necessary to achieve a specific signal-to-noise
- ratio:
+ To compute how much more signal is available over the minimum to neces-
+ sary 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).
+ 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.
+ 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 perspec-
+ tive. 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.
+ 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).
+ In this example, _\bt_\bo_\bp_\bo_\b__\bm_\ba_\bp_\b._\bp_\bp_\bm will illustrate the locations of the
+ transmitter and receiver sites specified. In addition, the great cir-
+ cle 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:
+ 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 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.
+ Up to five separate city files may be passed to S\bSP\bPL\bLA\bAT\bT!\b! at a time fol-
+ lowing 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:
+ 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:
+ 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.
+ 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:
+ 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
+ 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:
+ 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
+ convert -transparent "#FFFFFF" white_map.ppm transparent_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
+ S\bSP\bPL\bLA\bAT\bT!\b! can analyze a transmitter or repeater site, or network of sites,
+ and predict the regional coverage for each site specified. In this
+ mode, S\bSP\bPL\bLA\bAT\bT!\b! can generate a topographic map displaying the geometric
+ line-of-sight coverage 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_\b-
+ _\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 fol-
+ lowing 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 bend-
+ ing. 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 counties.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.
+ 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 propagation analysis. Any appro-
+ priate 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.
+ 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 aver-
+ age 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:
+ 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 exam-
+ ple:
- splat -t site1 site2 site3 site4 -c 10.0 -metric -o net-
- work.ppm
+ splat -t site1 site2 site3 site4 -c 10.0 -metric -o network.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):
+ 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 coverage area of the transmitters are plotted as follows
+ in the colors indicated (along with their corresponding RGB values in
+ decimal):
site1: Green (0,255,0)
site2: Cyan (0,255,255)
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
+ 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 loca-
+ tions on a single tower may be generated by S\bSP\bPL\bLA\bAT\bT!\b!.
+
+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 generated:
+
+ 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 illustrating expected
+ signal levels in areas surrounding the transmitter site. A legend at
+ the bottom of the map correlates each color with a specific path loss
+ range in decibels.
+
+ The _\b-_\bd_\bb 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, S\bSP\bPL\bLA\bAT\bT!\b!'s path loss plot
+ can be constrained to the region bounded by the 140 dB attenuation con-
+ tour as follows:
+
+ splat -t wnjt-dt -L 30.0 -s cities.dat -b co34_d00.dat -db 140 -o
+ plot.ppm
+
+ The path loss contour threshold may be expressed as either a positive
+ or negative quantity.
+
+ The path loss analysis range may be modified to a user-specific dis-
+ tance 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 pre-
+ diction map.
+
+ The colors used to illustrate contour regions in S\bSP\bPL\bLA\bAT\bT!\b! generated cov-
+ erage 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,
+ _\b._\bs_\bc_\bf, and _\b._\bd_\bc_\bf extensions. If the necessary file does not exist in the
+ current working when S\bSP\bPL\bLA\bAT\bT!\b! is run, a file containing default color
+ definition parameters that is suitable for manual editing by the user
+ is written into the current directory.
+
+ When a regional Longley-Rice analysis is performed and the transmit-
+ ter's ERP is not specified or is zero, a _\b._\bl_\bc_\bf path loss color defini-
+ tion file corresponding to the transmitter 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 correspond-
+ ing to the transmitter 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!.
+
+ 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:
+ ; Format for the parameters held in this file is as follows:
;
; 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.
+ ; "red", "green", and "blue" are the corresponding RGB color
+ ; definitions ranging from 0 to 255 for the region specified.
;
; The following parameters may be edited and/or expanded
- ; for future runs of SPLAT! A total of 32 contour
- regions
+ ; for future runs of SPLAT! A total of 32 contour regions
; may be defined in this file.
;
;
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 con-
+ tour.
+
+F\bFI\bIE\bEL\bLD\bD S\bST\bTR\bRE\bEN\bNG\bGT\bTH\bH A\bAN\bNA\bAL\bLY\bYS\bSI\bIS\bS
+ If the transmitter's effective radiated power (ERP) is specified in the
+ transmitter's _\b._\bl_\br_\bp file, or expressed on the command-line using the
+ _\b-_\be_\br_\bp switch, field strength contours referenced to decibels over one
+ microvolt per meter (dBuV/m) rather than path loss are produced:
+
+ splat -t wnjt-dt -L 30.0 -erp 46000 -db 30 -o plot.ppm
- 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.
+ The _\b-_\bd_\bb 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.
- 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):
+ S\bSP\bPL\bLA\bAT\bT!\b! field strength color definition files share a very similar
+ structure to _\b._\bl_\bc_\bf files used for plotting path loss:
- ; SPLAT! Auto-generated Signal Color Definition ("wnjt-
- dt.scf") File
+ ; SPLAT! Auto-generated Signal Color Definition ("wnjt-dt.scf") File
;
- ; Format for the parameters held in this file is as fol-
- lows:
+ ; Format for the parameters held in this file is as follows:
;
; 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.
+ ; ...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 specified.
;
; The following parameters may be edited and/or expanded
- ; for future runs of SPLAT! A total of 32 contour
- regions
+ ; for future runs of SPLAT! A total of 32 contour regions
; may be defined in this file.
;
;
18: 142, 63, 255
8: 140, 0, 128
+ If the signal strength is greater than or equal to 128 dB over 1 micro-
+ volt 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 dis-
+ played, 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 ser-
+ vices in the United States are as follows:
+
- 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
------------------------------
Digital Service Contour: 65 dBuV/m
+R\bRE\bEC\bCE\bEI\bIV\bVE\bED\bD P\bPO\bOW\bWE\bER\bR L\bLE\bEV\bVE\bEL\bL A\bAN\bNA\bAL\bLY\bYS\bSI\bIS\bS
+ If the transmitter's effective radiated power (ERP) is specified in the
+ transmitter's _\b._\bl_\br_\bp file, or expressed on the command-line using the
+ _\b-_\be_\br_\bp switch, and the _\b-_\bd_\bb_\bm switch is invoked, received power level con-
+ tours referenced to decibels over one milliwatt (dBm) are produced:
+
+ splat -t wnjt-dt -L 30.0 -erp 46000 -dbm -db -100 -o plot.ppm
+
+ The _\b-_\bd_\bb 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.
+
+ S\bSP\bPL\bLA\bAT\bT!\b! 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:
+
+ ; SPLAT! Auto-generated DBM Signal Level Color Definition ("wnjt-
+ dt.dcf") File
+ ;
+ ; Format for the parameters held in this file is as follows:
+ ;
+ ; dBm: red, green, blue
+ ;
+ ; ...where "dBm" is the received signal power level between +40 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
+
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):
+ Normalized field voltage patterns for a transmitting antenna's horizon-
+ tal and vertical planes are imported automatically into S\bSP\bPL\bLA\bAT\bT!\b! when a
+ path loss, field strength, or received power level coverage analysis is
+ performed. Antenna pattern data is read from a pair of files having
+ the same base name as the transmitter and LRP files, but with _\b._\ba_\bz and
+ _\b._\be_\bl extensions for azimuth and elevation pattern files, respectively.
+ Specifications regarding pattern rotation (if any) and mechanical beam
+ tilt and tilt direction (if any) are also contained 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 pattern file might
+ appear as follows (_\bk_\bv_\be_\ba_\b._\ba_\bz):
183.0
0 0.8950590
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):
+ The first line of the _\b._\ba_\bz file specifies the amount of azimuthal pat-
+ tern rotation (measured clockwise in degrees from True North) to be
+ applied by S\bSP\bPL\bLA\bAT\bT!\b! to the data contained in the _\b._\ba_\bz 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 structure of S\bSP\bPL\bLA\bAT\bT!\b! elevation pattern files is slightly different.
+ The first line of the _\b._\be_\bl file specifies 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, 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
+ separated by whitespace. Elevation 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 elevations _\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 pattern file might
+ appear as follows (_\bk_\bv_\be_\ba_\b._\be_\bl):
1.1 130.0
-10.0 0.172
-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):
+ In this example, the antenna is mechanically tilted downward 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.
+
+E\bEX\bXP\bPO\bOR\bRT\bTI\bIN\bNG\bG A\bAN\bND\bD I\bIM\bMP\bPO\bOR\bRT\bTI\bIN\bNG\bG R\bRE\bEG\bGI\bIO\bON\bNA\bAL\bL C\bCO\bON\bNT\bTO\bOU\bUR\bR D\bDA\bAT\bTA\bA
+ Performing a regional coverage analysis based on a Longley-Rice path
+ analysis can be a very time consuming process, especially if the analy-
+ sis is performed repeatedly to discover what effects changes to a
+ transmitter's antenna radiation pattern make to the predicted coverage
+ area.
+
+ This process can be expedited by exporting the contour data produced by
+ S\bSP\bPL\bLA\bAT\bT!\b! to an alphanumeric output _\b(_\b._\ba_\bn_\bo_\b) file. The data contained in
+ this file can then be modified to incorporate antenna pattern effects,
+ and imported back into S\bSP\bPL\bLA\bAT\bT!\b! to quickly produce a revised contour map.
+ Depending on the way in which S\bSP\bPL\bLA\bAT\bT!\b! is invoked, alphanumeric output
+ files can describe regional path loss, signal strength, or received
+ signal power levels.
+
+ For example, an alphanumeric output file containing path loss informa-
+ tion 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 maximum
+ path loss of 140 dB (assuming ERP is not specified in the transmitter's
+ _\b._\bl_\br_\bp file) using the following syntax:
+
+ splat -t kvea -L 30.0 -R 50.0 -db 140 -ano pathloss.dat
+
+ If ERP is specified in the _\b._\bl_\br_\bp file or on the command line through the
+ _\b-_\be_\br_\bp switch, the alphanumeric output file will instead contain pre-
+ dicted field values in dBuV/m. If the _\b-_\bd_\bB_\bm command line switch is
+ used, then the alphanumeric output file will contain receive signal
+ power levels in dBm.
+
+ S\bSP\bPL\bLA\bAT\bT!\b! alphanumeric output files can exceed many hundreds of megabytes
+ in size. They contain information relating to the boundaries of the
+ region they describe followed by latitudes (degrees North), longitudes
+ (degrees West), azimuths (referenced to True North), elevations (to the
+ first obstruction), followed by either path loss (in dB), received
+ field strength (in dBuV/m), or received signal power level (in dBm)
+ w\bwi\bit\bth\bho\bou\but\bt r\bre\beg\bga\bar\brd\bd t\bto\bo t\bth\bhe\be t\btr\bra\ban\bns\bsm\bmi\bit\btt\bti\bin\bng\bg a\ban\bnt\bte\ben\bnn\bna\ba'\b's\bs r\bra\bad\bdi\bia\bat\bti\bio\bon\bn p\bpa\bat\btt\bte\ber\brn\bn.
+
+ The first few lines of a S\bSP\bPL\bLA\bAT\bT!\b! alphanumeric output file could take on
+ the following 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!.
+ 35, 34 ; max_north, min_north
+ 34.2265424, 118.0631096, 48.199, -32.747, 67.70
+ 34.2270358, 118.0624421, 48.199, -19.161, 73.72
+ 34.2275292, 118.0617747, 48.199, -13.714, 77.24
+ 34.2280226, 118.0611072, 48.199, -10.508, 79.74
+ 34.2290094, 118.0597723, 48.199, -11.806, 83.26 *
+ 34.2295028, 118.0591048, 48.199, -11.806, 135.47 *
+ 34.2299962, 118.0584373, 48.199, -15.358, 137.06 *
+ 34.2304896, 118.0577698, 48.199, -15.358, 149.87 *
+ 34.2314763, 118.0564348, 48.199, -15.358, 154.16 *
+ 34.2319697, 118.0557673, 48.199, -11.806, 153.42 *
+ 34.2324631, 118.0550997, 48.199, -11.806, 137.63 *
+ 34.2329564, 118.0544322, 48.199, -11.806, 139.23 *
+ 34.2339432, 118.0530971, 48.199, -11.806, 139.75 *
+ 34.2344365, 118.0524295, 48.199, -11.806, 151.01 *
+ 34.2349299, 118.0517620, 48.199, -11.806, 147.71 *
+ 34.2354232, 118.0510944, 48.199, -15.358, 159.49 *
+ 34.2364099, 118.0497592, 48.199, -15.358, 151.67 *
+
+ 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, 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 _\b-_\bL switch _\bi_\bf 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 S\bSP\bPL\bLA\bAT\bT!\b! 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 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 _\bn_\bu_\bm_\be_\br_\bi_\bc _\bc_\bo_\bl_\bu_\bm_\bn 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.
+
+ Modified alphanumeric output files can be imported back into S\bSP\bPL\bLA\bAT\bT!\b!
+ for generating revised coverage maps provided that the ERP and -dBm
+ options are used as they were when the alphanumeric output file was
+ originally generated:
+
+ splat -t kvea -ani pathloss.dat -s city.dat -b county.dat -o map.ppm
+
+ Note that alphanumeric output files generated by splat cannot be used
+ with splat-hd, or vice-versa due to the resolution incompatibility
+ between the two versions of the program. Also, each of the three types
+ of alphanumeric output files are incompatible with one another, so a
+ file containing path loss data cannot be imported into S\bSP\bPL\bLA\bAT\bT!\b! to pro-
+ duce signal strength or received power level contours, etc.
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:
+ A user-defined terrain file is a user-generated text file containing
+ latitudes, longitudes, and heights above ground level of specific ter-
+ rain 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:
+ 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!.
+ 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 inter-
+ preted as being 3-arc seconds in both latitude and longitude in splat
+ and 1 arc-second in latitude and longitude in splat-hd. Features
+ 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! to avoid ambiguity.
+
+G\bGR\bRO\bOU\bUN\bND\bD C\bCL\bLU\bUT\bTT\bTE\bER\bR
+ The height of ground clutter can be specified using the _\b-_\bg_\bc switch:
+
+ splat -t wnjt-dt -r kd2bd -gc 30.0 -H wnjt-dt_path.png
+
+ The _\b-_\bg_\bc switch as the effect of raising the overall terrain by the
+ specified amount in feet (or meters if the _\b-_\bm_\be_\bt_\br_\bi_\bc 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.
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:
+ 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 follows:
splat -t tx_site -r rx_site -n -o topo_map.ppm
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:
+ 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
+ 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.
+ where -R specifies the minimum radius of the map in miles (or kilome-
+ ters 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 infor-
+ mation is desired, simply 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.
+ 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 cur-
+ rent 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:
+ 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) software 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
+ 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.
+ 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 interpre-
+ tation 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:
+ Keyhole Markup Language files compatible with G\bGo\boo\bog\bgl\ble\be E\bEa\bar\brt\bth\bh may be gen-
+ erated 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.
+ 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 _\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 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.
+ 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
+ S\bSP\bPL\bLA\bAT\bT!\b! determines antenna height above average terrain (HAAT) according
+ to the procedure defined by Federal Communications 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 available), then those radials are omitted from
+ the calculation of average terrain.
+
+ 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 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 ques-
+ tion 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.
+ When performing area prediction analysis, enough topography 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.
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.
+ 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>
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>
+ Ron Bentley <_\br_\bo_\bn_\bb_\be_\bn_\bt_\bl_\be_\by_\b@_\be_\bm_\bb_\ba_\br_\bq_\bm_\ba_\bi_\bl_\b._\bc_\bo_\bm>
Fresnel Zone plotting and clearance determination
-KD2BD Software 16 September 2007 SPLAT!(1)
+KD2BD Software 15 November 2008 SPLAT!(1)