commit 82a8c3ff1b524232edeebd51c482029976d036b4 Author: Emery Hemingway Date: Mon Feb 21 11:36:08 2022 -0600 Initial commit diff --git a/README.md b/README.md new file mode 100644 index 0000000..44c6997 --- /dev/null +++ b/README.md @@ -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) diff --git a/Tupfile b/Tupfile new file mode 100644 index 0000000..dc96653 --- /dev/null +++ b/Tupfile @@ -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 diff --git a/forest-view-site_report.txt b/forest-view-site_report.txt new file mode 100644 index 0000000..1d08f98 --- /dev/null +++ b/forest-view-site_report.txt @@ -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 + +--------------------------------------------------------------------------- + diff --git a/forest-view.kml b/forest-view.kml new file mode 100644 index 0000000..e501435 --- /dev/null +++ b/forest-view.kml @@ -0,0 +1,53 @@ + + + + + SPLAT! + forest-view Transmitter Contours + + SPLAT! Signal Strength Contours + SPLAT! Coverage + + forest-view.ppm + + + 41.99917 + 41.00000 + -91.00083 + -92.00000 + 0.0 + + + + Color Key + Contour Color Key + + forest-view-ck.ppm + + + + + + + + forest-view + 1 + + + 1 + relativeToGround + -91.542972,41.684750,20.000000 + + + + diff --git a/forest-view.png b/forest-view.png new file mode 100644 index 0000000..055c86f Binary files /dev/null and b/forest-view.png differ diff --git a/forest-view.qth b/forest-view.qth new file mode 100644 index 0000000..20a05cb --- /dev/null +++ b/forest-view.qth @@ -0,0 +1,4 @@ +forest-view +41 41 5.1 +91 32 34.7 +20 diff --git a/forest-view.scf b/forest-view.scf new file mode 100644 index 0000000..14a5029 --- /dev/null +++ b/forest-view.scf @@ -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 diff --git a/splat.lrp b/splat.lrp new file mode 100644 index 0000000..ed68863 --- /dev/null +++ b/splat.lrp @@ -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)