Initial commit

This commit is contained in:
Emery Hemingway 2022-02-21 11:36:08 -06:00
commit 82a8c3ff1b
8 changed files with 166 additions and 0 deletions

19
README.md Normal file
View File

@ -0,0 +1,19 @@
# Mesh line-of-sight estimations
This repository contains data for rough line-of-sight analysis of radio sites.
To analyze a site, create a '*.qth' file and run the `tup` utility in the repo.
The current analysis parameters are very rough guesses and over-estimates,
please consult the documentation of SPLAT! before tweaking them.
## Dependecies
* [Tup](https://gittup.org/tup)
* [SPLAT!](https://www.qsl.net/kd2bd/splat.html)
* [GraphicsMagick](http://www.graphicsmagick.org/)
## TODO
- Use recent LIDAR [data](http://www.geotree.uni.edu/en/extension/iowa-lidar-mapping-project/)
for topography rather than the 30-meter resolution [SRTM](https://en.wikipedia.org/wiki/Shuttle_Radar_Topography_Mission) data.
## Example
![](./forest-view.png)

32
Tupfile Normal file
View File

@ -0,0 +1,32 @@
.gitignore
!curl = |> curl -o %o |>
!unzip = |> unzip %f |> %B
# High-res LIDAR data is available but SPLAT! can't read it.
# TOOD: covert .las data to .sdf
# https://www.geotree.uni.edu/lidar/
# !fetch-lidar = |> curl https://geotree2.geog.uni.edu/IowaLidar/%o > %o |>
# : |> !fetch-lidar |> 06204614.las.7z
# : |> !fetch-lidar |> 06204614.xyzi.7z
: foreach *.7z |> 7z x %f |> %B
# SRTM data
!fetch-srtm = |> curl -o %o https://firmware.ardupilot.org/SRTM/North_America/%o |>
: |> !fetch-srtm |> N41W092.hgt.zip {hgtZip}
: foreach *hgt.zip |> !unzip |> %B
: N41W092.hgt |> srtm2sdf %f |> 41:42:91:92.sdf {sdf}
# Shapefiles
## use a throwaway account
IOWAGIS_USER = IlxJ
IOWAGIS_PASS = e/m1QIJV@tal{>+B:_/3~9_{]
# : |> !curl --user '$(IOWAGIS_USER):$(IOWAGIS_PASS)' https://www.iowagisdata.org/remote.php/webdav/County/Johnson/Open/%o |> fgdb_Cell_Towers.zip
: foreach *.qth | {sdf} |> splat -o %B -t %f -L 20 -db 56 -R 8 -kml |> \
%B.ppm %B-site_report.txt %B.kml %B.scf %B-ck.ppm
: foreach *.ppm |> gm convert %f %o |> %B.png

View File

@ -0,0 +1,21 @@
--==[ SPLAT! v1.4.2 Site Analysis Report For: forest-view ]==--
---------------------------------------------------------------------------
Site location: 41.6847 North / 91.5430 West (41° 41' 5" N / 91° 32' 34" W)
Ground elevation: 731.63 feet AMSL
Antenna height: 20.00 feet AGL / 751.63 feet AMSL
Antenna height above average terrain: 16.55 feet
Average terrain at 0 degrees azimuth: 763.03 feet AMSL
Average terrain at 45 degrees azimuth: 797.90 feet AMSL
Average terrain at 90 degrees azimuth: 773.30 feet AMSL
Average terrain at 135 degrees azimuth: 702.91 feet AMSL
Average terrain at 180 degrees azimuth: 656.82 feet AMSL
Average terrain at 225 degrees azimuth: 710.43 feet AMSL
Average terrain at 270 degrees azimuth: 732.47 feet AMSL
Average terrain at 315 degrees azimuth: 743.72 feet AMSL
---------------------------------------------------------------------------

53
forest-view.kml Normal file
View File

@ -0,0 +1,53 @@
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://earth.google.com/kml/2.1">
<!-- Generated by SPLAT! Version 1.4.2 -->
<Folder>
<name>SPLAT!</name>
<description>forest-view Transmitter Contours</description>
<GroundOverlay>
<name>SPLAT! Signal Strength Contours</name>
<description>SPLAT! Coverage</description>
<Icon>
<href>forest-view.ppm</href>
</Icon>
<LatLonBox>
<north>41.99917</north>
<south>41.00000</south>
<east>-91.00083</east>
<west>-92.00000</west>
<rotation>0.0</rotation>
</LatLonBox>
</GroundOverlay>
<ScreenOverlay>
<name>Color Key</name>
<description>Contour Color Key</description>
<Icon>
<href>forest-view-ck.ppm</href>
</Icon>
<overlayXY x="0" y="1" xunits="fraction" yunits="fraction"/>
<screenXY x="0" y="1" xunits="fraction" yunits="fraction"/>
<rotationXY x="0" y="0" xunits="fraction" yunits="fraction"/>
<size x="0" y="0" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>
<Placemark>
<name>forest-view</name>
<visibility>1</visibility>
<Style>
<IconStyle>
<Icon>
<href>root://icons/palette-5.png</href>
<x>224</x>
<y>224</y>
<w>32</w>
<h>32</h>
</Icon>
</IconStyle>
</Style>
<Point>
<extrude>1</extrude>
<altitudeMode>relativeToGround</altitudeMode>
<coordinates>-91.542972,41.684750,20.000000</coordinates>
</Point>
</Placemark>
</Folder>
</kml>

BIN
forest-view.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 968 KiB

4
forest-view.qth Normal file
View File

@ -0,0 +1,4 @@
forest-view
41 41 5.1
91 32 34.7
20

28
forest-view.scf Normal file
View File

@ -0,0 +1,28 @@
; SPLAT! Auto-generated Signal Color Definition ("forest-view.scf") File
;
; 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 specified.
;
; The following parameters may be edited and/or expanded
; for future runs of SPLAT! A total of 32 contour regions
; may be defined in this file.
;
;
128: 255, 0, 0
118: 255, 165, 0
108: 255, 206, 0
98: 255, 255, 0
88: 184, 255, 0
78: 0, 255, 0
68: 0, 208, 0
58: 0, 196, 196
48: 0, 148, 255
38: 80, 80, 255
28: 0, 38, 255
18: 142, 63, 255
8: 140, 0, 128

9
splat.lrp Normal file
View File

@ -0,0 +1,9 @@
15.000 ; Earth Dielectric Constant (Relative permittivity)
0.005 ; Earth Conductivity (Siemens per meter)
301.000 ; Atmospheric Bending Constant (N-units)
5000.0 ; Frequency in MHz (5 GHz)
5 ; Radio Climate (5 = Continental Temperate)
1 ; Polarization (0 = Horizontal, 1 = Vertical)
0.50 ; Fraction of situations (50% of locations)
0.90 ; Fraction of time (90% of the time)
4.0 ; Effective Radiated Power (ERP) in Watts (optional)