Imported Upstream version 1.2.0b upstream/1.2.0b
authorBdale Garbee <bdale@gag.com>
Thu, 5 Jun 2008 23:33:50 +0000 (17:33 -0600)
committerBdale Garbee <bdale@gag.com>
Thu, 5 Jun 2008 23:33:50 +0000 (17:33 -0600)
CHANGES
README
docs/pdf/splat.pdf
docs/postscript/splat.ps
docs/text/spanish/splat.txt [new file with mode: 0644]
splat-1.2.0.lsm [deleted file]
splat-1.2.0b.lsm [new file with mode: 0644]
splat-1.2.0b.tar.gz [new file with mode: 0644]
splat.cpp

diff --git a/CHANGES b/CHANGES
index ff1365601eb2cb7b1ab02520ba5481721a20d8c5..138b18acb5d11eda73f85da327cea6bf6eaeb566 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,15 @@
+Release 1.2.0b:
+By John A. Magliacane, <kd2bd@amsat.org> (15-Mar-2007):
+
+* Two bugs affecting the plotting of Fresnel zones were identified and fixed.
+
+* A bug that produced some erroneous elevation angles in SPLAT! Path Loss
+  Output (-plo option) files was identified and fixed.
+
+* Text documentation in Spanish was added (thanks to Charles Esobar).
+
+----------------------------------------------------------------------------
+
 Release 1.2.0:
 By John A. Magliacane, <kd2bd@amsat.org> (22-Dec-2006):
 
@@ -203,4 +215,3 @@ Release 1.0.0:
 by John A. Magliacane <kd2bd@amsat.org> (08-Apr-2002):
 
 * First public release of SPLAT!
-
diff --git a/README b/README
index cb612ac149f75aaced890b263085b946bafac819..114a4b937a4e1eec6608ebf9edffd1c4b882e3a7 100644 (file)
--- a/README
+++ b/README
@@ -7,7 +7,7 @@ Requirements
 ============
 SPLAT! requires the libbzip2-1.0.1 (or later) compression library and
 header files for successful compilation.  bzip2/libbzip2 is available
-at: http://sources.redhat.com/bzip2/
+at: http://www.bzip.org/
 
 SPLAT! also requires the zlib general purpose compression library.
 Any recent version included with your Linux distribution should work
@@ -39,13 +39,13 @@ Unpack the tar.gz file in a source code directory (such as /usr/src
 under Slackware) as 'root':
 
        cd /usr/src
-       tar xvfz splat-1.2.0.tar.gz
+       tar xvfz splat-1.2.0a.tar.gz
 
-This action will generate a subdirectory named splat-1.2.0.
+This action will generate a subdirectory named splat-1.2.0a.
 
 Next, cd into the directory:
 
-       cd splat-1.2.0
+       cd splat-1.2.0a
 
 Invoke the configure script to build SPLAT! and related utilities:
 
@@ -61,7 +61,7 @@ will be prompted to su to 'root' and invoke the install script manually:
        exit
 
 Before running SPLAT!, carefully read the documentation located under
-the splat-1.2.0/docs directory for information on the use of the program.
+the splat-1.2.0a/docs directory for information on the use of the program.
 
 REMEMBER: Topography data must be downloaded and SPLAT Data Files must
 be generated using the included srtm2sdf, postdownload, or usgs2sdf
@@ -91,7 +91,7 @@ $HOME/.splat_path file so SPLAT! can easily find them.
 Please read the README file under the utils directory for information
 on the utilities included with SPLAT!.
 
-Please read the documentation under the splat-1.2.0/docs directory,
+Please read the documentation under the splat-1.2.0a/docs directory,
 or consult the program's man page for more information and examples
 of SPLAT! use.
 
@@ -102,4 +102,5 @@ can be found on the SPLAT! Web Site:
 
 --
 John A. Magliacane, KD2BD
-December 20, 2006
+January 2007
+
index b12fbbf726612f4504b8ac4d21e59b4b36ceba24..10d7a669c6bdfeaec02e70a9486fd9d3caa1cacd 100644 (file)
Binary files a/docs/pdf/splat.pdf and b/docs/pdf/splat.pdf differ
index aa1924925fa2d72fdad77b917358cceaef62d163..3873d5a117840841e795e0c479ffdbe9c443d904 100644 (file)
@@ -1,6 +1,6 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.17.2
-%%CreationDate: Fri Dec 22 13:04:16 2006
+%%CreationDate: Fri Jan 19 15:42:11 2007
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%+ font Times-Italic
diff --git a/docs/text/spanish/splat.txt b/docs/text/spanish/splat.txt
new file mode 100644 (file)
index 0000000..0286253
--- /dev/null
@@ -0,0 +1,503 @@
+SPLAT!(1)                 KD2BD Software                SPLAT!(1)
+
+
+NOMBRE
+SPLAT!  es una herramienta para el análisis de Propagación de Señales RF, Pérdidas, y características del Terreno (RF Signal Propagation, Loss, And Terrain analysis tool).
+
+
+SINOPSIS
+
+splat [-t txsite(s).qth] [-r rxsite.qth] [-c grafica área(s) de cobertura  del TX(s) con una antena RX a X pies sobre el nivel del terreno] [-L altura de la antena receptora para el análisis de cobertura Longley-Rice (pies/metros)(flotante)] [-p perfil_terreno.ext] [-e perfil_elevación.ext] [-h perfil_altura.ext] [-H perfil_altura_normalizada.ext] [-l perfil_Longley-rice.ext] [-o nombrearchivo_mapa_topografico.ppm] [-b nombrearchivo_limites_cartograficos.dat] [-s basedatos_sitio/ciudad.dat] [-d path_directorio_sdf] [-m multiplicador del radio de la tierra (flotante)] [-f frecuencia (MHz) para los cálculos de la zona de Fresnel (flotante)] [-R radio máximo de cobertura (millas/kilómetros) (flotante)] [-dB máximo contorno de atenuación a ser presentado sobre un mapa de pérdidas por trayectoria (80-230 dB)] [-nf no graficar las zonas de Fresnel en los gráficos de altura] [-plo archivosalida_perdidas_por_trayectoria.txt] [-pli archivoentrada_pérdidas_por_trayectoria.txt] [-udt archivo_terreno_definido_por_usuario.txt] [-n] [-N] [-geo] [-kml] [-metric]
+
+
+DESCRIPCIÓN
+SPLAT! es una  poderosa herramienta  para el análisis de terreno y propagación RF cubriendo el espectro entre 20 Megahertz y 20 Gigahertz. SPLAT! es Software Libre y está diseñado para operar en escritorios Unix y basados en Linux. La redistribución y/ó modificación está permitida bajo los términos de la licencia pública general GNU según lo publicado por la Fundación de Software Libre, versión 2 ó superiores. La adopción del código fuente de SPLAT! en aplicaciones propietarias o de fuente-cerrada  es una violación de esta licencia, y esta estrictamente prohibida. 
+
+SPLAT! se distribuye con la esperanza de que sea útil, pero SIN NINGUNA GARANTÍA, aún la garantía implícita de COMERCIALIZACIÓN  o de la APLICACIÓN PARA UN PROPÓSITO PARTICULAR. Vea la licencia GNU para más detalles.
+
+INTRODUCCIÓN
+Las aplicaciones de SPLAT! incluyen la visualización, diseño, y análisis de enlaces  de  redes inalámbricas WAN, sistemas de radio comunicaciones comerciales y aficionados  sobre los 20 megahertz,  enlaces  microonda, estudios de interferencia y coordinación de frecuencias, y determinación del contorno de cobertura de las regiones  de radio y televisión terrestres análogas y digitales. 
+
+SPLAT! proporciona datos de ingeniería RF del sitio, tales como; distancias sobre el arco terrestre y azimut entre sitios de transmisión y recepción, ángulos de elevación de la antena (uptilt), ángulos de  depresión (downtilt), altura de la antena sobre nivel del mar, altura de la antena sobre el promedio del terreno, azimut y distancias para determinar obstrucciones, Atenuaciones de trayectoria Longley-Rice , y  requisitos mínimos necesarios de altura de las antenas  para establecer trayectorias de comunicación de línea-de-vista sin obstrucciones debido al terreno, la primera zona de Fresnel, y el 60% de la primera zona de Fresnel.
+
+SPLAT! produce informes, gráficos, y  mapas topográficos altamente detallados y cuidadosamente descritos que presentan las trayectorias de línea-de-vista,  contornos regionales de pérdidas por trayectoria para determinar la predicción del área de cobertura de sistemas de transmisores y  repetidoras. Al realizar análisis de línea de vista cuando se emplean múltiples sitios de transmisores o repetidores, SPLAT! determina las áreas  individuales y  mutuas de cobertura dentro de la red especificada. 
+
+Simplemente tipee splat en la consola de comandos, esto retornará un resumen de las opciones de comando de SPLAT!
+
+      --==[ SPLAT! v1.2.0 Available Options... ]==--
+
+       -t txsite(s).qth (sitio de transmisión, max of 4)
+       -r rxsite.qth (sitio de recepción)
+       -c grafica área(s) de cobertura  del TX(s) con una antena RX a X pies sobre el nivel promedio del terreno
+       -L grafica las pérdidas por trayectoria desde el sitio de transmisión (TX) y una antena receptora (RX) a X pies/metros sobre el nivel promedio del terreno AGL
+       -s nombres de archivos(s) de ciudades/sitios para importar (máximo 5)
+       -b nombres de archivos(s) de límites cartográficos para importar (máximo 5)
+       -p nombre de archivo para graficar el perfil del terreno 
+       -e nombre de archivo para graficar la elevación del terreno
+       -h nombre de archivo para graficar la altura del terreno 
+       -H nombre de archivo para graficar la altura normalizada del terreno
+       -l nombre de archivo para graficar el modelo Longley-Rice
+       -o nombre de archivo para generar el mapa topográfico (.ppm)
+       -u nombre del archivo del terreno definido-por-el-usuario a importar
+       -d ruta al directorio que contiene los archivos sdf (reemplaza al declarado en el archivo ~/.splat_path)
+       -n no analisis, breve reporte
+       -N no análisis, no reporte
+       -m multiplicador del radio de la tierra
+       -f frecuencia para el cálculo de la zona de Fresnel (MHz)
+       -R modifica el rango por defecto para -c ó -L (millas/kilómetros)
+      -db Contorno máximo de pérdidas a ser presentado en el mapa de pérdidas por trayectoria  (80-230 dB)
+      -nf no grafica la zona de Fresnel en  los gráficos de  altura 
+     -plo nombre del archivo de salida de pérdidas-por-trayectoria 
+     -pli nombre del archivo de entrada de pérdidas-por-trayectoria 
+     -udt nombre del archivo de entrada de terreno definido-por-el-usuario 
+     -geo genera un archivo Xastir de georeferencia .geo (con salida .ppm) 
+     -kml genera un archivo Google Earth .kml (para enlaces punto-a-punto)
+  -metric emplea unidades métricas en lugar de las imperiales para todas las I/O del usuario
+
+
+FICHEROS DE ENTRADA
+SPLAT! es una aplicación manejada por linea de comandos ó terminal de textos (shell), y lee los datos de entrada a través de un número de ficheros de datos. Algunos archivos son obligatorios para la apropiada ejecución del programa, mientras que otros son opcionales. Los archivos obligatorios incluyen los modelos topográficos 3-arco segundo en la forma de archivos de datos de SPLAT (archivos SDF), archivos de localización del sitio (archivos QTH), y archivos de parámetros para el modelo  Longley-Rice (archivos LRP). Los archivos opcionales incluyen archivos de localización de ciudades/sitios, archivos de límites cartográficos, archivos de terreno definidos por el usuario, archivos de entrada de pérdidas-por-trayectoria, y archivos de patrones de radiación de antenas.
+
+FICHEROS DE DATOS SPLAT 
+SPLAT! importa los datos topográficos desde los ficheros de datos SPLAT (SDFs). Estos archivos se pueden generar desde varias fuentes de información. En los Estados Unidos, los ficheros de datos  SPLAT se pueden generar a través de la U.S.  Geological Survey Digital Elevation Models (DEMs) usando la herramienta usgs2sdf incluida con SPLAT!. Los modelos de elevación digital USGS compatibles con esta utilidad pueden ser descargados de:   http://edcftp.cr.usgs.gov/pub/data/DEM/250/.
+
+Una resolución significativamente mejor se puede obtener con el uso de los modelos digitales de  elevación versión 2 SRTM-3. Estos modelos son el resultado de la misión topografíca del radar  espacial Shuttle STS-99, y están disponibles para la mayoría de las regiones pobladas de la tierra. Los ficheros de datos SPLAT pueden ser generados desde los datos SRTM usando la herramienta incluida srtm2sdf. Los archivo SRTM-3 versión 2 se pueden obtener a través de FTP anónimo desde: ftp://e0srp01u.ecs.nasa.gov:21/srtm/version2/ 
+
+A pesar de la exactitud más alta que los datos SRTM ofrecen, existen  algunos vacíos en los conjuntos de datos. Cuando se detectan estos vacíos, la utilidad srtm2sdf los substituye por los datos  encontrados en los  archivos SDF existentes (que presumiblemente fueron creados de datos anteriores de la USGS con la utilidad usgs2sdf). Si los datos SDF, USGS-derivados no están disponibles, los vacíos se reemplazan con el promedio de los pixeles adyacentes, o  reemplazo directo.
+
+Los ficheros de datos de SPLAT contienen valores enteros de las elevaciones topográficas (en metros) referidos al nivel del mar para regiones de la tierra de 1-grado por 1-grado con una resolución de 3-arco segundos. Los archivos SDF pueden ser leídos desde el formato estándar (sdf) generado por las utilidades usgs2sdf  y srtm2sdf, ó en formato comprimido bzip2 (.sdf .bz2). Puesto que los archivos sin comprimir se pueden procesar ligeramente más rápido que los archivos comprimidos, SPLAT! busca los datos SDF necesarios en formato sin comprimir primero. Si los datos sin comprimir no pueden ser localizados, SPLAT entonces busca los datos en formato comprimido  bzip2. Si tampoco se pueden encontrar los archivos SDF comprimidos  para la región solicitada, SPLAT! asume que la región es el océano, y asignará una elevación del nivel del mar a estas áreas.
+
+Esta característica de SPLAT! permite realizar el análisis de trayectorias no solamente sobre la tierra, sino también entre las áreas costeras no representadas por los datos del Modelo de Elevación Digital. ¡Este comportamiento de SPLAT! resalta la importancia de tener todos los archivos SDF requeridos para la región a ser analizada, para así obtener resultados significativos.
+
+ARCHIVOS DE LOCALIZACIÓN DEL SITIO (QTH)
+SPLAT! importa la  información de la localización de los sitios del transmisor y del receptor analizados por el programa de los archivos ASCII que tienen una extensión .qth. Los archivos QTH contienen:
+
+El nombre del sitio
+La latitud del sitio (positiva al norte del ecuador, negativa al sur)
+La longitud del sitio (en grados oeste W de 0 a 360 grados), y;
+La altura de la antena del sitio sobre el nivel del suelo (AGL). 
+
+Un caracter de salto-de-linea separa cada campo. La altura de la antena se asume a ser especificada en pies a menos que sea seguida por la letra m o de la palabra  meters  en mayúsculas ó minúsculas. La información de la latitud y de la longitud se puede expresar en  formato decimal (74.6889) ó en formato grados, minutos, segundos (DMS) (74 41 20.0). 
+
+Por ejemplo, un archivo de localización de sitio que describía la estación de televisión WNJT, Trenton, NJ (wnjt.qth) se puede  leer como sigue:
+
+ WNJT
+ 40.2833
+ 74.6889
+ 990.00
+
+ó en formato de grados, minutos, segundos (DMS) (corazon.qth).
+
+Cerro Corazón
+-1 -8 -11.0
+79 03 40
+40 m
+
+Cada sitio de transmisor y receptor analizado por SPLAT! debe ser representado por su propio archivo de la localización de sitio (QTH).
+
+SPLAT! importa los datos de parámetros para el modelo Longley-Rice desde los archivos que tienen el mismo nombre base del archivo QTH del sitio del transmisor, pero con una extensión .lrp   proporcionando así una correlación simple y exacta entre estos conjuntos de datos asociados. El formato para los archivos de parámetros para el modelo Longley-Rice es como sigue (wnjt.lrp):
+
+15.000  ; Constante Dieléctrica de la Tierra (Permitividad Relativa)
+0.005   ; Conductividad de la Tierra (Siemens por metro)
+301.000 ; Constante de deflexión Atmosférica (N-unidades)
+700.000 ; Frecuencia en MHz (20 MHz to 20 GHz)
+5       ; Clima de Radio (5 =  Continental  Templado)
+0       ; Polarización (0 = Horizontal, 1 = Vertical)
+0.5     ; Fracción de  situaciones  (50%  de  localizaciones)
+0.5     ; Fracción de tiempo (50% de tiempo)
+
+Si el archivo LRP correspondiente al archivo QTH del sitio de transmisión no puede ser encontrado, SPLAT! explorará el directorio de trabajo actual buscando el archivo "splat.lrp". ¡Si este archivo tampoco puede ser encontrado, entonces los parámetros por defecto enumerados arriba serán asignados por SPLAT! y un archivo correspondiente "splat.lrp" que contiene estos datos será escrito al directorio de trabajo actual. El archivo "splat.lrp" se puede editar de acuerdo a las necesidades del usuario. 
+
+Las constantes dieléctricas típicas de la tierra y sus valores de conductividad son los siguientes:
+
+                                              Constante Dieléctrica                 Conductividad
+               Salt water       :             80                                    5.000
+               Good ground      :             25                                    0.020
+               Fresh water      :             80                                    0.010
+               Marshy land      :             12                                    0.007
+               Farmland, forest :             15                                    0.005
+               Average ground   :             15                                    0.005
+               Mountain, sand   :             13                                    0.002
+               City             :             5                                     0.001
+               Poor ground      :             4                                     0.001
+
+      Los códigos de Clima de Radio usados por SPLAT! son los siguientes:
+
+               1: Equatorial (Congo)
+               2: Continental Subtropical (Sudan)
+               3: Maritime Subtropical (West coast of Africa)
+               4: Desert (Sahara)
+               5: Continental Temperate
+               6: Maritime Temperate,  over  land  (UK  and  west coasts of US & EU)
+               7: Maritime Temperate, over sea
+
+El clima templado continental es común a las grandes masas de la tierra en la zona templada, tal como los Estados Unidos. Para trayectorias inferiores a 100 kilómetros, es poca diferencia entre los climas templados continentales y marítimos.
+
+Los dos parámetros finales en el archivo .lrp corresponden al análisis estadístico proporcionado por el modelo Longley-Rice. En este ejemplo, SPLAT! devolverá la máxima pérdida de trayectoria que ocurre el 50%  del tiempo (fracción del tiempo) en el 50% de las situaciones (fracción de situaciones). En los Estados Unidos utilice una fracción de 0.97 del parámetro de tiempo para televisión  digital, y 0.50 para analógica. Se asumen antenas isotrópicas.
+
+Para mayor información de esos parámetros, puede visitar: http://flattop.its.bldrdoc.gov/itm.html  y         
+http://www.softwright.com/faq/engineering/prop_longley_rice.html  
+
+ARCHIVOS DE LOCALIZACIÓN DE CIUDADES
+Los nombres y las localizaciones de ciudades, sitios de la torre, u otros puntos del interés se pueden importar y trazar en los mapas topográficos generados por SPLAT!. SPLAT! importa los nombres de ciudades y localizaciones de los archivos ASCII que contienen:
+
+El nombre de la localización, la latitud de la localización, y la longitud de la localización
+
+Cada campo es separado por una coma. Cada expediente es separado por un caracter de salto-de-linea. Al igual que con los archivos .qth, la información de la latitud y la longitud se puede ingresar en  formato decimal ó en formato de grados, minutos, segundos (DMS).
+
+Por ejemplo en formato decimal (cities.dat):
+
+Teaneck, 40.891973, 74.014506
+Tenafly, 40.919212, 73.955892
+Teterboro, 40.859511, 74.058908
+Tinton Falls, 40.279966, 74.093924
+Toms River, 39.977777, 74.183580
+Totowa, 40.906160, 74.223310
+Trenton, 40.219922, 74.754665
+
+
+Un total de cinco ficheros de datos separados de ciudades se pueden importar a la vez, y no hay límite al tamaño de estos archivos. SPLAT! lee datos de las ciudades en base a "primero ingresada primero servida", y traza solamente las localizaciones cuyas anotaciones no estén en conflicto con anotaciones de las localizaciones trazadas anteriormente durante la ejecución de SPLAT!. Este comportamiento en SPLAT! reduce al mínimo el alboroto al generar  los mapas topográficos, pero también determina que por mandato las localizaciones importantes estén puestas al principio del primer fichero de datos de ciudades, y las localizaciones de menor importancia sean colocadas a continuación en la lista o en los ficheros de datos subsecuentes.
+
+Los ficheros de datos de las ciudades se pueden generar manualmente usando cualquier editor de textos, importar de otras fuentes, o derivar de los datos disponibles de la oficina de censo de los Estados Unidos, usando la herramienta incluida con SPLAT! citydecoder. Estos datos están disponibles gratuitamente vía Internet en: http://www.census.gov/geo/www/cob/bdy_files.html, y deben estar en formato ASCII.
+
+
+ARCHIVOS DE DATOS DE LIMITES CARTOGRÁFICOS
+Los datos cartográficos de límites se pueden también importar para trazar los límites de las ciudades,  condados, o estados en los mapas topográficos generados por SPLAT!. Estos datos deben estar en el formato de  metadatos de archivos cartográficos de límites  ARC/INFO Ungenerate (formato ASCII), y están disponibles para los E.E.U.U..en la Oficina de Censos vía Internet en: http://www.census.gov/geo/www/cob/co2000.html#ascii y http://www.census.gov/geo/www/cob/pl2000.html#ascii. Un total de cinco archivos cartográficos separados de límites se puede importar a la vez. No es necesario importar límites de estado si ya  se han importado los límites del condado.
+
+OPERACIÓN DEL PROGRAMA
+Debido a que SPLAT! hace un uso intensivo del CPU y la memoria, SPLAT! se invoca vía línea de comandos usando una serie de opciones y argumentos, este tipo de interfaz reduce al mínimo gastos indirectos y se presta a operaciones  escriptadas. El uso de CPU y memoria por SPLAT! se pueden modificar con el uso de comandos Unix. 
+
+El número y el tipo de opciones pasados a SPLAT! determinan su modo de operación y el método de generación de los datos de  salida. Casi todos los opciones de SPLAT! se pueden conectar en cascada y en cualquier orden al invocar el programa desde la línea de comandos.
+
+SPLAT! funciona en dos modos distintos: modo punto-a-punto, y modo de predicción del área de cobertura, y puede ser invocado por el usuario usando el modo de línea de vista (LOS) ó el  modelo Longley-Rice de propagación sobre terreno irregular (ITM). 
+
+El radio de tierra verdadera, cuatro-tercios, o cualquier otro radio de la tierra pueden ser especificados al realizar los análisis de línea-de-vista.
+
+
+ANÁLISIS PUNTO-A-PUNTO
+SPLAT! puede ser utilizado para determinar si existe línea de vista entre dos localizaciones especificadas realizando para ello el análisis del perfil del terreno. Por ejemplo:
+
+splat -t tx_site.qth -r rx_site.qth
+
+invoca un análisis del perfil del terreno entre el transmisor especificado en tx_site.qth y el receptor especificado en rx_site.qth, y escribe un  Reporte de Obstrucciones SPLAT! al directorio de trabajo actual. El reporte contiene los detalles de los sitios del transmisor y del receptor, e identifica la localización de cualquier obstrucción detectada a lo largo de la trayectoria de línea-de-vista. Si una obstrucción puede ser despejada levantando la antena de recepción a una mayor altitud, SPLAT! indicará la altura mínima de la antena requerida para que exista línea-de-vista entre las localizaciones del transmisor y el receptor especificadas. Observe que las unidades imperiales (millas, pies) se usan por defecto, a menos que se use la opción -metric en la orden SPLAT! de línea de comandos.
+
+splat -t tx_site.qth -r rx_site.qth -metric
+
+Si la antena se debe levantar una cantidad significativa, esta determinación puede tomar una cierta cantidad de tiempo. Observe que los resultados proporcionados son el mínimo necesario para que exista una trayectoria de la línea de vista, y en el caso de este simple ejemplo, no considera los requisitos de la zona de Fresnel.
+
+Las extensiones .qth son asumidas por SPLAT! para los archivos QTH, y son opcionales al invocar el programa. ¡SPLAT! lee automáticamente todos los ficheros de datos de SPLAT necesarios para el análisis del terreno entre los sitios especificados. SPLAT! busca primero los archivos SDF necesarios  en el directorio de trabajo actual. Si estos archivos no se encuentran, SPLAT! entonces busca en la ruta especificada por la opción – d:
+
+splat -t tx_site -r rx_site -d /cdrom/sdf/
+
+Una ruta a un directorio externo puede ser especificada creando el archivo ".splat_path" en el directorio de trabajo del usuario. Este archivo $HOME/.splat_path debe contener una sola línea de texto ASCII en  la que indique la ruta  completa  del directorio que contiene todos los archivos SDF.  
+
+/opt/splat/sdf/
+
+Y puede ser generado usando cualquier editor de texto.
+
+Un gráfico que muestre el perfil del terreno en función de la distancia, partiendo desde el receptor, entre las localizaciones del transmisor y receptor se puede generar adicionando la opción -p:
+
+ splat -t tx_site -r rx_site -p terrain_profile.png
+
+SPLAT! invoca al programa gnuplot cuando genera los gráficos. La extensión del nombre del archivo especificado por SPLAT! determina el formato del gráfico a ser producido .png generará un archivo de gráfico PNG a color con una resolución de 640x480, mientras que .ps o .postscript generarán archivos de salida postscritp. La salida en formatos como GIF, Adobe Illustrator, AutoCAD dxf, LaTex, y muchos otros están disponibles. Por favor consulte gnuplot, y la documentación de gnuplot para detalles de todos los formatos de salida soportados.
+
+En el lado del receptor  un gráfico de elevaciones en función de la distancia determinado por el ángulo de inclinación debido al terreno entre el receptor y el transmisor se puede generar usando la opción -e:
+
+splat -t tx_site -r rx_site -e elevation_profile.png
+
+El gráfico producido usando la opción -e ilustra los ángulos de elevación y depresión   resultado del terreno entre la localización del receptor y el sitio del transmisor desde la perspectiva   del receptor. Un segundo trazo es dibujado entre el lado izquierdo del gráfico (localización del receptor) y la localización de la antena que transmite a la derecha. Este trazo ilustra el ángulo de elevación requerido para que exista  una trayectoria de línea de vista entre el receptor y transmisor. Si la traza interseca el perfil de elevación en cualquier punto del gráfico, entonces esto es una indicación que bajo las condiciones dadas no existe una trayectoria de línea-de-vista, y las obstrucciones se pueden identificar claramente en el gráfico en los puntos de intersección.
+
+Un gráfico ilustrando la altura del terreno referenciado a la trayectoria de línea de vista entre el transmisor y el receptor se puede generar usando la opción -h:
+
+splat -t tx_site -r rx_site -h height_profile.png
+
+La altura del terreno normalizada a las alturas de las antenas del transmisor y receptor pueden ser obtenidas con la opción -H:
+
+splat -t tx_site -r rx_site -H normalized_height_profile.png
+
+El contorno de curvatura de la tierra también es graficada en este modo.
+
+La primera Zona de Fresnel, y el 60% de la primera Zona de Fresnel puede ser adicionada al gráfico de perfiles de altura con la opción -f, y especificando una frecuencia (en MHz) a la cual la Zona de Fresnel será modelada:
+
+splat  ‐t  tx_site  ‐r  rx_site  ‐f  439.250  ‐H   normalized_height_profile.png
+
+
+Un gráfico que muestre las pérdidas de trayectoria Longley-Rice se puede dibujar usando la opción -l :
+
+splat -t tx_site -r rx_site -l path_loss_profile.png
+
+Como antes, adicionando la opción -metric se forza al gráfico a usar unidades de medida métrica.
+
+Al realizar el perfil de las pérdida de trayectoria, un Reporte de las Pérdidas por Trayectoria del Modelo  Longley-Rice es generado por SPLAT! en un archivo de texto con extensión .lro . El informe contiene el azimut y las distancias entre el transmisor y el receptor, así como la pérdida de trayectoria Longley-Rice para varias distancias entre el transmisor y el receptor. El modo de propagación para los puntos a lo largo de la trayectoria se da como Línea-de-Vista, Horizonte Simple, Horizonte Doble, Difracción dominante, y Troposcatter dominante.
+
+Para determinar la relación señal-a-ruido (SNR) en el sitio remoto donde el ruido (térmico) aleatorio de Johnson es el el factor limitante primario en la recepción:
+
+ SNR=T-NJ-L+G-NF
+
+donde T es la potencia ERP del transmisor en dBW, NJ es el ruido de Johnson en dBW (-136 dBW para un canal de  TV de 6 Mhz), L es las pérdidas de trayectoria proporcionadas por SPLAT! en dB (como un número positivo), G es la ganancia de la antena receptora en dB referenciada a un radiador isotrópico, y NF es la figura de ruido en el receptor en dB.
+
+T puede ser computado como sigue:
+
+T=TI+GT
+
+donde TI es la cantidad actual de potencia RF entregada a la antena transmisora en dBW, GT  es la ganancia de la antena transmisora (referenciada a una isotrópica) en la dirección del receptor (ó al horizonte si el receptor está sobre el horizonte.
+
+Para calcular cuanta mas señal está disponible sobre el mínimo necesario para conseguir una específica relación señal-a-ruido:
+
+Signal_Margin=SNR-S
+
+donde S es la mínima relación SNR deseada (15.5 dB para ATSC DTV, 42 dB para televisión analógica NTSC).
+
+Un mapa topográfico puede ser generado por SPLAT! para visualizar la trayectoria entre el transmisor y el receptor desde otra perspectiva. Los mapas topográficos generados por SPLAT! presenta las elevaciones usando una escala de grises logarítmica, con las elevaciones más altas representadas a través de capas más brillantes de gris. El rango dinámico de la imagen es escalada entre las elevaciones más altas y más bajas presentes en el mapa. La única excepción de esto es al nivel del mar, el cual se representa usando el color azul.
+
+La salida topográfica se puede especificar  usando la opción -o :
+
+splat -t tx_site -r rx_site -o topo_map.ppm
+
+La extensión .ppm del archivo de salida es asumida por SPLAT!,  y es opcional.
+
+En este ejemplo, topo_map.ppm ilustrará las localizaciones de los sitios especificados del transmisor y del receptor. Además, la trayectoria entre los dos sitios será dibujada sobre las localizaciones para las cuales existe una trayectoria sin obstáculo hacia el transmisor con  una altura de la antena de recepción  igual a la del sitio del receptor (especificado en rx_site.qth).
+
+Puede ser deseable poblar el mapa topográfico con nombres y localizaciones de ciudades, sitios de torres, o de otras localizaciones importantes. ¡Un archivo de ciudades se puede pasar a SPLAT! usando  la opción -s :
+
+splat -t tx_site -r rx_site -s cities.dat -o topo_map
+
+Hasta cinco archivos separados pueden ser pasados a SPLAT! a la vez luego de la opción -s . 
+
+Límites de estados y ciudades pueden ser adicionados al mapa especificando hasta cinco archivos de límites cartográficos de Censo Bureu de los U.S. usando el switch -b :
+
+splat -t tx_site -r rx_site -b co34_d00.dat -o topo_map
+
+En situaciones donde múltiples sitios de transmisores están en uso, se pueden pasar  a SPLAT! hasta cuatro localizaciones simultáneas para sus  análisis:
+
+splat -t tx_site1 tx_site2 tx_site3 tx_site4 -r rx_site -p profile.png
+
+En este ejemplo, SPLAT! genera cuatro reportes separados de obstrucción y de perfiles de terreno . Un simple mapa topográfico puede ser especificado usando la opción -o , y las trayectorias de línea de vista entre cada transmisor y el sitio indicado del receptor será producido en el mapa, cada uno en su propio color. La trayectoria entre el primer transmisor especificado al receptor será verde, la trayectoria entre el segundo transmisor y el receptor  será cyan, la trayectoria entre el tercer transmisor y el receptor será violeta, y la trayectoria entre el cuarto transmisor y el receptor será siena.
+
+Los mapas topográficos generados por SPLAT! son imágenes TrueColor PixMap Portables de 24-bit  (PPM) y pueden ser vistos, corregidos, o convertidos a otros formatos gráficos usando  populares programas de imágenes tales como xv, The GIMP, ImageMagick, y XPaint. El formato png es altamente recomendado para el almacenamiento comprimido sin pérdidas de los archivos topográficos de salida  generados por SPLAT!. La utilidad de línea de comandos ImageMagick's convierte fácilmente los archivos gráficos SPLAT! PPM al formato PNG:
+
+convert splat_map.ppm splat_map.png
+
+Otra utilidad de de línea de comandos excelente para convertir archivos PPM  a  PNG es wpng, y está disponible en: http://www.libpng.org/pub/png/book/sources.html . Como recurso adicional, los archivos PPM pueden ser comprimidos usando la utilidad bzip2, y ser leídos directamente en este formato por The GIMP. 
+
+DETERMINANDO LA COBERTURA REGIONAL
+SPLAT! puede analizar un sitio de transmisor o repetidora, ó redes de sitios, y predecir la cobertura regional para cada sitio especificado. En este modo SPLAT! puede generar un mapa topográfico presentando la geometría del área de cobertura  de línea de vista de los sitios, basados en la localización de cada sitio y la altura de la antena receptora que se desea comunicar con el sitio en cuestión. SPLAT! se swichea desde el modo de análisis punto-a-punto al modo de predicción de cobertura  cuando se invoca la opción -c como sigue:
+
+splat  -t tx_site -c 30.0 -s cities.dat -b co34_d00.dat -o tx_coverage
+
+En este ejemplo, SPLAT! genera un mapa topográfico llamado tx_coverage.ppm que ilustra la predicción de cobertura regional de línea de vista del tx_site a las estaciones receptoras que tienen una antena de 30 pies de altura sobre el nivel del terreno (AGL). Si la opción -metric es usada, el argumento que sigue a la opción -c es interpretada en metros, en lugar de pies. El contenido de cities.dat son dibujados sobre el mapa, como también los límites cartográficos contenidos en el archivo co34_d00.dat .
+
+Cuando se grafica las trayectorias de línea-de-vista y las áreas de cobertura regional, SPLAT! por defecto no considera los efectos de la flexión atmosférica. Sin embargo esta característica puede ser modificada usando el multiplicador de radio de la tierra con la opción -m .
+
+splat -t wnjt -c 30.0 -m  1.333  -s  cities.dat  -b  counties.dat -o map.ppm
+
+Un radio multiplicador de 1.333 instruye a SPLAT! a usar el modelo de “cuatro-tercios” para el análisis de propagación de línea de vista. Cualquier multiplicador del radio de la tierra apropiado puede ser seleccionado por el usuario.
+
+Cuando SPLAT! es invocado en el modo de predicción de cobertura,  genera un reporte para cada estación analizada. Los reportes de sitio SPLAT! contienen detalles de la localización geográfica del sitio, su altura sobre el nivel del mar, la altura de la antena sobre el promedio del terreno, y la altura del promedio del terreno calculada en las direcciones de los azimut de 0, 45, 90, 135, 180, 225, 270, y 315 grados.
+
+
+DETERMINANDO REGIONES MÚLTIPLES DE COBERTURA
+SPLAT! también puede presentar áreas de cobertura de línea-de-vista hasta para  cuatro sitios de transmisores separados sobre un mapa topográfico común. Por ejemplo:
+
+splat -t site1 site2 site3 site4 -c 10.0 -metric -o network.ppm
+
+Grafica las coberturas regionales de línea de vista del  site1 site2 site3 site4 basado en una antena receptora localizada a 10.0 metros sobre el nivel del terreno. Un mapa topográfico entonces es escrito al archivo network.ppm . El área de cobertura de línea de vista del transmisor es graficada como sigue en los colores indicados junto con sus valores RGB correspondientes en decimal.
+
+           site1: Green (0,255,0)
+           site2: Cyan (0,255,255)
+           site3: Medium Violet (147,112,219)
+           site4: Sienna 1 (255,130,71)
+
+           site1 + site2: Yellow (255,255,0)
+           site1 + site3: Pink (255,192,203)
+           site1 + site4: Green Yellow (173,255,47)
+           site2 + site3: Orange (255,165,0)
+           site2 + site4: Dark Sea Green 1 (193,255,193)
+           site3 + site4: Dark Turquoise (0,206,209)
+
+           site1 + site2 + site3: Dark Green (0,100,0)
+           site1 + site2 + site4: Blanched Almond (255,235,205)
+           site1 + site3 + site4: Medium Spring Green (0,250,154)
+           site2 + site3 + site4: Tan (210,180,140)
+
+           site1 + site2 + site3 + site4: Gold2 (238,201,0)
+
+Si se generan archivos .qth separados, cada uno representando una localización de un sitio común, pero con diferentes alturas de antena, SPLAT! puede generar un mapa topográfico sencillo que ilustra la cobertura regional desde las estaciones (hasta cuatro) separadas por la altura en un única torre.
+
+
+ANALISIS DE PÉRDIDAS POR TRAYECTORIA LONGLEY-RICE
+Si la opción -c se reemplaza por la opción -L, se puede generar un mapa de pérdidas de trayectorias Longley-Rice:
+
+splat  -t  wnjt  -L  30.0 -s cities.dat -b co34_d00.dat -o path_loss_map 
+
+En este modo, SPLAT! genera un mapa multicolor que ilustra los niveles de señal esperados (pérdidas por trayectoria) en las áreas alrededor del transmisor. Una leyenda en la parte inferior del mapa relaciona cada color con sus respectivas pérdidas por trayectoria específicas en decibeles. 
+
+El rango de análisis puede modificado con la opción -R . El argumento debe ser dado en millas (ó kilómetros si la opción -metric es usada). Si se especifica un rango mayor que el mapa topográfico  generado, SPLAT! realizará los cálculos de perdidas Longley-Rice de trayectoria entre todas las cuatro esquinas del área del mapa  de predicción.
+
+La opción -db permite limitar el máximo de perdidas de la región a ser graficada en el mapa. Pérdidas de trayectoria entre 80 y 230 dB pueden ser especificadas usando esta opción. Por ejemplo si las perdidas por debajo de -140 dB son irrelevantes al análisis que se está realizando,  entonces las pérdidas a ser graficadas por SPLAT! pueden ser limitadas a la región de atenuación del contorno de 140 dB como sigue:
+
+splat -t wnjt -L 30.0 -s cities.dat  -b  co34_d00.dat  -db 140 -o plot.ppm
+
+
+PARÁMETROS PARA PATRONES DE RADIACIÓN DE ANTENAS
+Los patrones de voltaje de campo normalizado para planos verticales y horizontales de antenas transmisoras son importados automáticamente dentro de SPLAT! cuando se realizan los análisis de cobertura Longley-Rice.  Los datos de los patrones de antena son leídos de un par de archivos que tienen el mismo nombre base que el transmisor y los archivos LRP, pero con extensiones .az y .el, para los patrones de azimut y elevación respectivamente. Especificaciones acerca de la rotación del patrón (si existe) e inclinación mecánica y dirección de la inclinación (si existe) también son contenidos dentro de los archivos de patrones de radiación de las antenas.
+
+Por ejemplo las primeras pocas líneas de un archivo de patrón de azimut SPLAT! podrían aparece como sigue  (kvea.az):
+               183.0
+               0       0.8950590
+               1       0.8966406
+               2       0.8981447
+               3       0.8995795
+               4       0.9009535
+               5       0.9022749
+               6       0.9035517
+               7       0.9047923
+               8       0.9060051
+
+La primera línea de el archivo .az especifica la cantidad de rotación del patrón de azimut (medido en grados desde el norte verdadero en sentido horario) a ser aplicado por SPLAT! a los datos contenidos en el archivo .az . Esto es seguido por el correspondiente azimut (0 a 360 grados) y su asociado patrón de campo normalizado (0.000 a 1.000) separado por un espacio en blanco.
+
+La estructura del archivo del patrón de elevación SPLAT! es ligeramente diferente. La primera línea del archivo .el especifica la cantidad de elevación mecánica aplicada a la antena. Note que una elevación hacia abajo (bajo el horizonte) es expresada como un ańgulo positivo, mientras que hacia arriba (sobre el horizonte) es expresada como un ángulo negativo. Estos datos son seguidos por la dirección del azimut de la elevación, separado por un espacio en blanco. 
+
+El remanente del archivo consiste en los valores de los ángulos de elevación y su correspondiente patrón de radiación de voltaje normalizado (0.000 a 1.000) separados por un espacio en blanco. Los ángulos de elevación deben ser especificados sobre un rango de -10 a +90 grados. Igual que la notación en la elevación mecánica, ángulos de elevación negativa son usados para representar elevaciones sobre el horizonte, mientras que los ángulos positivos representan elevaciones bajo el horizonte.
+
+Por ejemplo las primeras pocas líneas de un archivo patrón de elevación SPLAT! podría aparecer como sigue (kvea.el):
+
+               1.1    130.0
+              ‐10.0   0.172
+              ‐9.5    0.109
+              ‐9.0    0.115
+              ‐8.5    0.155
+              ‐8.0    0.157
+              ‐7.5    0.104
+              ‐7.0    0.029
+              ‐6.5    0.109
+              ‐6.0    0.185
+
+En este ejemplo, la antena es mecanicamente inclinada hacia abajo 1.1 grados hacia un azimut de 130 grados
+
+Para mejores resultados, la resolución de los datos de patrones de radiación debería ser especificados lo mas cerca posibles a los grados azimut, y la resolución de datos del patrón de elevación deverían ser especificados lo mas cerca posible a 0.01 grados. Si los datos del patrón especificado no alcanzan este nivel de resolución, SPLAT! interpolará los valores provistos para determinar los datos en la resolución requerida, aunque esto puede resultar en una pérdida en exactitud.
+       
+
+IMPORTANDO Y EXPORTANDO DATOS DEL CONTORNO REGIONAL DE PÉRDIDAS POR TRAYECTORIA
+
+Realizar un análisis de cobertura Longley-Rice puede ser un proceso que consuma mucho tiempo, especialmente si el análisis es repetido varias veces para descubrir cuales son los efectos que los cambios a los patrones de radiación de las antenas hacen a la predicción del área de cobertura
+
+Este proceso puede ser apresurado al exportar los datos del contorno regional de pérdidas por trayectoria a un archivo de salida, modificar externamente los datos de pérdida por trayectoria para incorporar los efectos de los patrones de antena, y entonces importar nuevamente los datos de pérdidas por trayectoria modificados dentro de SPLAT! para rapidamente producir un mapa revisado de pérdidas por trayectoria.
+
+Por ejemplo un archivo de salida de pérdidas por trayectoria puede ser generado por SPLAT! para un sitio de recepción a 30 pies sobre el nivel del terreno, con un radio de 50 millas alrededor del sitio de transmisión para pérdidas por trayectoria máximas de 140 dB, usando la siguiente sintaxis:
+
+       splat ‐t kvea ‐L 30.0 ‐R 50.0 ‐db 140 ‐plo pathloss.dat
+
+Los archivos de salida por pérdidas por trayectoria a menudo exceden los 100 megabytes de tamaño. Contienen la información referentes a los límites de la región que describen seguido por latitudes (grados norte), longitudes(grados oeste), azimut, elevaciones(a la primera obstrucción), y figuras de pérdidas por trayectoria(dB) para una serie de puntos específicos que abarca la región que rodea al sitio de transmisión. Las primeras pocas líneas de un archivo de salida de pérdidas por trayectoria SPLAT! tiene la siguiente apariencia (pathloss.dat):
+
+               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
+
+
+No es poco común para los archivos SPLAT! de pérdidas por trayectoria que contengan tanto como 3 millones o más de líneas de datos. Si el archivo es procesado, comentarios pueden ser puestos con un caracter de punto y coma. El editor de texto vim ha probado ser capaz de editar archivos de este tamaño.
+
+Note que al igual que el caso de los archivos de patrones de antena, ángulos de elevación negativos se refieren a inclinaciones hacia arriba (sobre el horizonte), mientras que ángulos positivos se refieren a inclinaciones hacia abajo (bajo el horizonte). Esos ángulos se refieren a la elevación para la antena receptora en la altura sobre el nivel del terreno especificada usando la opción -L si la trayectoria entre el transmisor y el receptor no tiene obstrucciones. Si la trayectoria entre el transmisor y el receptor está obstruida, entonces el ángulo a la primera obstrucción es retornado por SPLAT!. Esto es porque el modelo Longley-Rice considera la energía que alcanza un punto distante sobre una trayectoria obstruida como un derivado de la energía dispersada de la punta de la primera instrucción, solamente. Puesto que la energía no puede alcanzar directamente la localización obstruida, el actual ángulo de elevación a ese punto es irrelevante.
+
+Cuando se modifican los archivos SPLAT! de pérdidas por trayectoria para reflejar datos de patrones de antena, solo la última columna (path loss) deberían ser enmendados para reflejar la ganacia de antena normalizada en los ángulos de elevación y azimut especificados en el archivo. (Por ahora, programas y scripts capaces de realizar esta operación son dejados como tarea al usuario.)
+
+Los mapas modificados de pérdidas por trayectoria pueden ser importados nuevamente a SPLAT! para generar mapas de cobertura revisados.
+
+splat ‐t kvea ‐pli pathloss.dat ‐s city.dat ‐b  county.dat ‐o map.ppm
+
+Los archivos SPLAT! de pérdidas por trayectoria también pueden ser usados para guiar estudios de cobertura o interferencia fuera de SPLAT!
+
+ARCHIVOS DE ENTRADA DE TERRENO DEFINIDOS POR EL USUARIO      
+Un archivo de terreno definido por el usuario es un archivo de texto generado-por-el-usuario que contiene latitudes, longitudes, y alturas sobre el nivel de la tierra de características de terreno específica que se cree son de importancia para el análisis que SPLAT! está desarrollando, pero perceptiblemente ausentes de los archivos SDF que están siendo usados. Un archivo de terreno definido-por-el-usuario es importado dentro de un análisis de SPLAT! usando la opción -udt :
+
+splat ‐t tx_site ‐r rx_site ‐udt udt_file.txt ‐o map.ppm
+
+Un archivo de terreno definido-por-el-usuario tiene la siguiente apariencia y estructura:
+
+              40.32180556, 74.1325, 100.0 meters
+              40.321805, 74.1315, 300.0
+              40.3218055, 74.1305, 100.0 meters
+
+La altura del terreno es interpretada en pies sobre el nivel del suelo a menos que sea seguido por la palabra meters, y es adicionado en la parte superior de el terreno especificado en los datos SDF para la localización especificada.
+
+Debe saber que las características especificadas en los archivos de terreno especificados-por-el-usuario serán interpretados como 3-arco segundos en latitud y longitud. Características descritas en el archivo de terreno definido-por-el-usuario que traslapen las características previamente definidas en el archivo son ignoradas por SPLAT!
+
+GENERACIÓN DE MAPAS TOPOGRÁFICOS SIMPLES
+En ciertas ocasiones puede ser deseable generar un mapa topográfico de una región sin graficar áreas de cobertura, trayectorias de línea-de-vista, o generar reportes de obstrucciones. Existen varias maneras de hacer esto. Si se desea generar un mapa topográfico ilustrando la localización de un sitio del transmisor  y receptor con un breve reporte de texto describiendo las localizaciones y distancias entre los sitios, entonces, entonces se debe invocar la opción -n  como sigue:
+
+splat -t tx_site -r rx_site -n -o topo_map.ppm
+
+Si no se desea un reporte de texto, entonces debe usar la opción -N :
+
+splat -t tx_site -r rx_site -N -o topo_map.ppm
+
+Si se omite la opción -o y el nombre del archivo  de salida cuando se usan las opciones -n ó -N , la salida será escrita a un archivo por defecto llamado map.ppm en el directorio actual de trabajo.
+
+DETERMINACIÓN DE LA ALTURA DE LA ANTENA SOBRE EL PROMEDIO DEL TERRENO
+SPLAT! determina la altura de la antena sobre el promedio del terreno (HAAT) de acuerdo al procedimiento definido por la Comisión Federal de Comunicaciones. Parte 73.313(d). De acuerdo a esta definición, la elevación del terreno a lo largo de ocho radiales entre 2 y 16 millas (3 y 16 Kilómetros) desde el sitio que está siendo analizado es muestreado y promediado para los azimut  cada 45 grados comenzando con el norte verdadero. Si uno o mas radiales caen enteramente sobre el mar o sobre el continente fuera de los Estados Unidos (áreas para las cuales no existen disponibles datos topográficos USGS), entonces esos radiales son omitidos de los cálculos del promedio del terreno. Si parte de los radiales se extienden sobre el mar o fuera de los Estados Unidos, entonces solo la parte de esos radiales que caen sobre la tierra de los Estados Unidos son usados en la determinación del promedio del terreno.
+
+Note que los datos de elevaciones SRTM, a diferencia de los antiguos datos 3-arcos segundos USGS, se extienden más allá de las fronteras de los Estados Unidos. Por esta razón,  los resultados  HAAT, no estarán en fiel cumplimiento con la FCC parte 73.313(d) en áreas a lo largo de la frontera de los Estados Unidos si los archivos SDF usados por SPLAT! son derivados-SRTM.
+
+Cuando se realiza análisis punto-a-punto del terreno, SPLAT! determina la altura de la antena sobre el promedio del  terreno solo si suficientes datos topográficos han sido cargados por el programa para realizar el análisis punto-a-punto. En la mayoría de los casos, esto será verdadero, a menos que el sitio en cuestión no esté dentro de 10 millas de la frontera de los datos topográficos cargados en memoria.
+
+Cuando se realiza el análisis de predicción de área, suficientes datos topográficos son normalmente cargados por SPLAT! para realizar los cálculos del promedio del terreno. Bajo esas condiciones, SPLAT! proveerá la altura de la antena sobre el promedio del terreno, como también el promedio del terreno sobre el nivel del mar para los azimut de 0, 45, 90, 135, 180, 225, 270,  y  315 grados, e incluirá dicha información en el reporte de sitio generado. Si uno o más de los ocho radiales caen sobre el mar o sobre regiones para las cuales no existen datos SDF disponibles, SPLAT!  reportará  sin terreno la trayectoria de los radiales afectados.
+
+RESTRINGIENDO EL TAMAÑO MÁXIMO DE UNA REGIÓN ANALIZADA
+SPLAT! lee los archivos SDF de acuerdo a sus necesidades dentro de una serie de “ranuras” de memoria dentro de la estructura del programa. Cada “ranura” contiene un archivo SDF representando una región de terreno de un grado por un grado. 
+
+Una sentencia  #define MAXSLOTS en las primeras líneas del archivo splat.cpp configura el máximo número de “ranuras”  disponibles para los datos topográficos. Esto también configura el  tamaño máximo de los mapas generados por SPLAT!. Por defecto MAXSLOTS es configurado a 9. Si SPLAT! produce un fallo de segmentación al arrancar con estos parámetros por defecto, significa que no hay suficiente memoria RAM y/ó memoria virtual (partición swap) para correr SPLAT! con este número de MAXSLOTS. En situaciones donde la memoria disponible es baja, MAXSLOTS pueden ser reducidos a 4 con el entendimiento de que esto limitará grandemente la máxima región que SPLAT! estará habilitado a analizar. Si se tiene disponible 118 megabytes ó mas de la memoria total (partición swap sumada la RAM), entonces MAXSLOTS puede ser incrementado a 16. esto permitirá operaciones sobre una región de 4-grados por 4-grados, lo cual es suficiente para alturas de antenas  que excedan los 10,000 pies sobre el nivel del mar, ó distancias punto-a-punto sobre las 1000 millas.
+
+GENERACIÓN DE ARCHIVOS DE GEOREFERENCIA
+Los mapas topográficos, de cobertura (-c), y contornos de pérdidas por trayectoria (-L) generados por SPLAT! pueden ser importados dentro del programa Xastir (X Amateur  Station Tracking and Information Reporting), generando un archivo de georeferencia usando la opción SPLAT -geo:
+
+splat ‐t kd2bd ‐R 50.0 ‐s NJ_Cities ‐b NJ_Counties ‐geo ‐o map.ppm
+
+El archivo de georeferencia creado tendrá el mismo nombre base que el archivo -o especificado, pero con extensión .geo, y permite la apropiada interpretación y presentación de los gráficos .ppm SPLAT! en el programa Xastir.
+      
+GENERACION DE ARCHIVOS KML GOOGLE MAP
+Archivos Keyhole Markup Language compatibles con Google Earth pueden ser generados por SPLAT! cuando se realizan análisis punto-a-punto invocando la opción -kml :
+
+splat ‐t wnjt ‐r kd2bd ‐kml
+
+El archivo KML generado tendrá la misma estructura que el nombre del Reporte de Obstrucciones para los sitios del transmisor y receptor dados, excepto que tendrá una extensión .kml .
+
+Una vez cargado dentro del Google Earth (Archivo --> Abrir), el archivo KLM exhibirá las localizaciones de los sitios de transmisión y recepción en el mapa. Los puntos de vista de la imagen serán desde la posición del sitio de transmisión mirando hacia la localización del receptor. La trayectoria punto-a-punto entre los sitios será presentada como una línea blanca, mientras que la trayectoria de linea-de-vista RF será presentada en verde. Las herramientas de navegación de Google Earth la permiten al usuario "volar" alrededor de la trayectoria, identificando señales, caminos, y otras características contenidas.
+
+
+INFORMACIÓN ADICIONAL
+Invocar SPLAT! sin ningún argumento desplegará todas las opciones de línea de comando disponibles del programa con una breve descripción de cada una de ellas.
+
+Las últimas noticias e información respecto al programa SPLAT! está disponible a través de la página web oficial localizada en: http://www.qsl.net/kd2bd/splat.html. 
+
+AUTORES
+       John A. Magliacane, KD2BD <kd2bd@amsat.org>
+              Creator, Lead Developer
+
+       Doug McDonald <mcdonald@scs.uiuc.edu>
+              Longley-Rice Model integration
+
+       Ron Bentley <ronbentley@earthlink.net>
+              Fresnel Zone plotting and clearance determination
+
+KD2BD Software           20 December 2006               SPLAT!(1)
+
+
+Traducción del manual al español por Charles Escobar (chescobar@gmail.com)
diff --git a/splat-1.2.0.lsm b/splat-1.2.0.lsm
deleted file mode 100644 (file)
index bd7e003..0000000
+++ /dev/null
@@ -1,38 +0,0 @@
-Begin3
-Title:         SPLAT!
-Version:       1.2.0
-Entered-date:  22DEC06
-Description:   SPLAT! is a terrestrial RF propagation analysis tool for
-               the spectrum between 20 MHz and 20 GHz.  SPLAT! provides
-               site engineering data such as the great circle distances
-               and bearings between sites, antenna elevation angles
-               (uptilt), depression angles (downtilt), antenna height
-               above mean sea level, antenna height above average
-               terrain, bearings and distances to known obstructions,
-               path loss based on the Longley-Rice Irregular Terrain
-               Model, and minimum antenna height requirements needed to
-               establish first Fresnel zone clearance and line-of-sight
-               RF paths absent of obstructions due to terrain.  SPLAT!
-               produces reports, graphs, and highly detailed and carefully
-               annotated topographic maps depicting line-of-sight paths,
-               path loss, and expected coverage areas of transmitters
-               and repeater systems.  Applications of SPLAT! include
-               site engineering, wireless network design, amateur
-               radio communications, frequency coordination,
-               communication system design, and terrestrial
-               television and radio broadcasting.  SPLAT! requires
-               gnuplot version 3.7, libbzip-1.0.1 or later, and
-               zlib, as well as an application capable of displaying
-               PPM graphic files (xv, ImageMagick, xpaint, The GIMP, etc.).
-Keywords:      Terrain analysis, site engineering, Longley-Rice path
-               loss, TV/FM radio broadcasting, TV/FM radio reception,
-               amateur radio, wireless WAN analysis and design
-Author:                kd2bd@amsat.org (John A. Magliacane) (Creator, Lead Developer)
-               mcdonald@scs.uiuc.edu (Doug McDonald) (L-R Model Integration)
-               ronbentley@earthlink.net (Ron Bentley) (Fresnel Zone Plotting)
-Maintained-by: kd2bd@amsat.org (John A. Magliacane)
-Primary-site:  ftp.ibiblio.org /pub/Linux/apps/ham/splat-1.2.0.tar.gz
-Original-site: http://www.qsl.net/kd2bd/splat.html
-Platforms:     Linux/Unix
-Copying-policy:        GPL
-End
diff --git a/splat-1.2.0b.lsm b/splat-1.2.0b.lsm
new file mode 100644 (file)
index 0000000..d1f438d
--- /dev/null
@@ -0,0 +1,38 @@
+Begin3
+Title:         SPLAT!
+Version:       1.2.0b
+Entered-date:  15MAR07
+Description:   SPLAT! is a terrestrial RF propagation analysis tool for
+               the spectrum between 20 MHz and 20 GHz.  SPLAT! provides
+               site engineering data such as the great circle distances
+               and bearings between sites, antenna elevation angles
+               (uptilt), depression angles (downtilt), antenna height
+               above mean sea level, antenna height above average
+               terrain, bearings and distances to known obstructions,
+               path loss based on the Longley-Rice Irregular Terrain
+               Model, and minimum antenna height requirements needed to
+               establish first Fresnel zone clearance and line-of-sight
+               RF paths absent of obstructions due to terrain.  SPLAT!
+               produces reports, graphs, and highly detailed and carefully
+               annotated topographic maps depicting line-of-sight paths,
+               path loss, and expected coverage areas of transmitters
+               and repeater systems.  Applications of SPLAT! include
+               site engineering, wireless network design, amateur
+               radio communications, frequency coordination,
+               communication system design, and terrestrial
+               television and radio broadcasting.  SPLAT! requires
+               gnuplot version 3.7, libbzip-1.0.1 or later, and
+               zlib, as well as an application capable of displaying
+               PPM graphic files (xv, ImageMagick, xpaint, The GIMP, etc.).
+Keywords:      Terrain analysis, site engineering, Longley-Rice path
+               loss, TV/FM radio broadcasting, TV/FM radio reception,
+               amateur radio, wireless WAN analysis and design
+Author:                kd2bd@amsat.org (John A. Magliacane) (Creator, Lead Developer)
+               mcdonald@scs.uiuc.edu (Doug McDonald) (L-R Model Integration)
+               ronbentley@earthlink.net (Ron Bentley) (Fresnel Zone Plotting)
+Maintained-by: kd2bd@amsat.org (John A. Magliacane)
+Primary-site:  ftp.ibiblio.org /pub/Linux/apps/ham/splat-1.2.0b.tar.gz
+Original-site: http://www.qsl.net/kd2bd/splat.html
+Platforms:     Linux/Unix
+Copying-policy:        GPL
+End
diff --git a/splat-1.2.0b.tar.gz b/splat-1.2.0b.tar.gz
new file mode 100644 (file)
index 0000000..4e37b80
Binary files /dev/null and b/splat-1.2.0b.tar.gz differ
index 4c801c02913af133d86f894db828b8584296056f..119551071b19919bf3723bc1f47952a86923acfb 100644 (file)
--- a/splat.cpp
+++ b/splat.cpp
@@ -1,6 +1,6 @@
 /****************************************************************************
 *      SPLAT: An RF Signal Propagation Loss and Terrain Analysis Tool       *
-*                        Last update: 21-Dec-2006                          *
+*                        Last update: 15-Mar-2007                          *
 *****************************************************************************
 *           Project started in 1997 by John A. Magliacane, KD2BD           *
 *****************************************************************************
@@ -56,7 +56,7 @@
 #define ARRAYSIZE 30025
 #endif
 
-char   string[255], sdf_path[255], opened=0, *splat_version={"1.2.0"};
+char   string[255], sdf_path[255], opened=0, *splat_version={"1.2.0b"};
 
 double TWOPI=6.283185307179586, HALFPI=1.570796326794896,
        PI=3.141592653589793, deg2rad=1.74532925199e-02,
@@ -2459,8 +2459,7 @@ void PlotLRPath(struct site source, struct site destination, FILE *fd)
        double  loss, azimuth, pattern=0.0, 
                source_alt, dest_alt, source_alt2, dest_alt2,
                cos_xmtr_angle, cos_test_angle=0.0, test_alt,
-               elevation, distance=0.0,
-               four_thirds_earth;
+               elevation, distance=0.0, four_thirds_earth;
        struct  site temp;
 
        ReadPath(source,destination);
@@ -2509,9 +2508,9 @@ void PlotLRPath(struct site source, struct site destination, FILE *fd)
                                   that determines the elevation angle to the first
                                   obstruction along the path is bypassed. */
 
-                               for (x=2, block=0; x<y && block==0; x++)
+                               for (x=2, block=0; (x<y && block==0); x++)
                                {
-                                       distance=5280.0*(path.distance[y]-path.distance[x]);
+                                       distance=5280.0*path.distance[x];
                                        test_alt=four_thirds_earth+path.elevation[x];
 
                                        /* Calculate the cosine of the elevation
@@ -3906,14 +3905,14 @@ void GraphHeight(struct site source, struct site destination, char *name, double
        {
                if (metric)
                {
-                       fprintf(fd3,"%f\t%f\n",path.distance[path.length-1],r);
-                       fprintf(fd4,"%f\t%f\n",path.distance[path.length-1],r);
+                       fprintf(fd3,"%f\t%f\n",KM_PER_MILE*path.distance[path.length-1],METERS_PER_FOOT*r);
+                       fprintf(fd4,"%f\t%f\n",KM_PER_MILE*path.distance[path.length-1],METERS_PER_FOOT*r);
                }
 
                else
                {
-                       fprintf(fd3,"%f\t%f\n",KM_PER_MILE*path.distance[path.length-1],METERS_PER_FOOT*r);
-                       fprintf(fd4,"%f\t%f\n",KM_PER_MILE*path.distance[path.length-1],METERS_PER_FOOT*r);
+                       fprintf(fd3,"%f\t%f\n",path.distance[path.length-1],r);
+                       fprintf(fd4,"%f\t%f\n",path.distance[path.length-1],r);
                }
        }
        
@@ -6017,7 +6016,8 @@ int main(char argc, char *argv[])
 
        if (freq==0.0 && nf==0)
                freq=LR.frq_mhz;
-       else
+
+       else if (nf==1)
                freq=0.0;
 
        if (coverage | LRmap)