This is the antenna performance plotted from tinyGS reception data.

Overview

tinyGS-antenna-map

This is the antenna performance plotted from tinyGS reception data. See their repository.

The code produces a plot that provides Azimuth and Elevation information showing the location in the sky, based on the observer/station, where the satellite reception is successful and packets are uploaded to TinyGS.

My four active stations show very different reception patterns. These are a 433Mhz vertical 1/4 wave antenna, a 433Mhz vertical dipole, a 433Mhz horizontal dipole, and a 1/4 wave 915 Mhz antenna (that has received nothing useful as there aren't any satellites presently transmitting). All are on the East side of the house and somewhat blocked towards the West.

W6LHI

Darker quadrants mean more reception. Individual packets received are the black dots. Packets received with CRC Errors are shown as red dots.

The center of the circle is exactly vertical from the observer/station. The edge of the circle is the horizon (well, kinda!).

For example, if you operate with a simple horizontal dipole, then you would see a bias in the data towards the higher reception direction (90 degrees from the dipole length). If you have a Al/Ez tracking antenna then you should see a very broad reception map.

The program will display the plot on the desktop if it is run in that environment. If you want a CLI process, then look at the -o flag below. The program uses Matplotlib and the install instructions are included - follow them carefully. All instructions are for Debian (and tested on a R.Pi). This code should work on other systems. Any problems? - please use GitHub issues.

Install

Download and install code from GitHub

The best copy of this code is always on GitHub. If you need the git command (and you will) do this part first:

$ sudo apt-get install -y git
...
$

Grab the code via this:

$ git clone https://github.com/mahtin/tinyGS-antenna-map.git
...
$ cd tinyGS-antenna-map
$

Installing required packages (i.e Matplotlib)

Please read and follow the INSTALL-MATPLOTLIB page. Then return here after that is finished.

Install continued

Once Matplotlib is install cleanly the code requires some additional packages/libraries:

$ sudo python3 -m pip install -U -r requirements.txt
...
$

Now the install is finished. Congratulations.

Setting up your user-id

To plot your own graphs from your own stations, you need to know what your own user-id on TinyGS is. The first option is to save it away in a file for all the code to use.

Storing your user-id

Your user-is can be found via various methods.

Assuming you are logged into TinyGS, you can visit https://tinygs.com and click on the User Console icon and then look at the resulting station URL (it will be something like: https://tinygs.com/user/20000007). The same user-id number can be seen in the URL for the per-station page.

user-id

Or, you can use your Telegram TinyGS Personal Bot channel to find your user-id. It's the last number from the passwordless login link you get with the /weblogin command.

user-id

The user-id is the URL provided (see example image).

Copy the number seens and use it to create a .user_id file via the following command:

$ echo '20000007' > .user_id
$

Your number will be different.

Specifying user for each run

If you choose, you specify your user-id manually on each command run. See the -u option below.

Plotting your antenna map

All your stations will be plotted on a single page. Make the displayed page larger if you need.

$ ./tinygs_antenna_map.py

This assumes that you are on a machine with a display. If you are headless, then the following will be useful:

$ ./tinygs_antenna_map.py -o > pretty-graph.png
$ scp pretty-graph.png somewhere-else.example.com:

If Matplotlib sends out warning messages about Connection Refused or Gdk-CRITICAL, it's because you can't connect to the display (even if you are trying to write an image file). This still produces an image. You can fix this by setting the MPLBACKEND environment variable (see Matplotlib builtin backends instructions):

$ MPLBACKEND=Agg ./tinygs_antenna_map.py -o > pretty-graph.png
...
$

tinygs_antenna_map.py options

The tinygs_antenna_map.py program takes various arguments.

tinygs_antenna_map [-v|--verbose] [-h|--help] [-r|--refresh] [-s|--station[,station...]] [-u|--user] user-id]
  • [-v|--verbose] - provide some information on each of the packets being processed/displayed.
  • [-h|--help] - this message.
  • [-r|--refresh] - presently unused; but will pull data from TinyGS site on demand.
  • [-s|--station[,station...]] - list the station or stations to plot. Use comma-seperated (i.e. A,B,C) for more than one station.
  • [-u|--user] user-id] - define the user-id vs using the .user_id file.
  • [-o|--output] - produce a PNG file on stdout (use: tinygs_antenna_map.py -o > diagram.png for example`).

Specifying the station or user-id

To produce a plot for a specific user (for example 20000007):

$ ./tinygs_antenna_map.py -u 20000007

Your number will be different.

To produce a plot for one of your specific stations, use the station name:

$ ./tinygs_antenna_map.py -s W6LHI_433Mhz

To produce a plot for someone else station (and I'm not judging you in anyway):

$ ./tinygs_antenna_map.py -s MALAONE -u 0

(No idea who MALAONE is). Note the -u 0 argument. This overtides your .user_id file if it exists (as this station is a different user).

Data refresh

The program can be run many times; however it will only collect new data from TinyGS API no-and-again. This is to reduce the load on their servers.

  • Packet data is updated at-best every twelve hours
  • Station data is updated at-best every five days
  • TLE data is updated at-best every two days

Should you want to force a data refresh, then use the -r flag. Don't blame me if you get banned from the site.

$ ./tinygs_antenna_map.py -r

I don't recommend using that flag.

Adding antenna direction graphics to the plot(s)

If you want to superimpose an antenna direction on the graphs; use the following examples:

An simple antenna direction for all ploted stations:

$ ./tinygs_antenna_map.py -a 220

An antenna direction for a specific ploted station:

$ ./tinygs_antenna_map.py -a [email protected]_433Mhz

An antenna direction for more than one ploted station:

$ ./tinygs_antenna_map.py -a [email protected]_433Mhz,[email protected]_433Mhz_2

The numbers are in degress and the comma seperated list must contain valid station names.

Owner
Martin J. Levy
Roaming the planet; one packet at a time! PGP: 7EA1 39C4 0C1C 842F 9D41 AAF9 4A34 925D 0517 2859 Ham operator: W6lHI/G8LHI
Martin J. Levy
Processing and interpolating spatial data with a twist of machine learning

Documentation | Documentation (dev version) | Contact | Part of the Fatiando a Terra project About Verde is a Python library for processing spatial da

Fatiando a Terra 468 Dec 20, 2022
Replace MSFS2020's bing map to google map

English verison here 中文 免责声明 本教程提到的方法仅用于研究和学习用途。我不对使用、拓展该教程及方法所造成的任何法律责任和损失负责。 背景 微软模拟飞行2020的地景使用了Bing的卫星地图,然而卫星地图比较老旧,很多地区都是几年前的图设置直接是没有的。这种现象在全球不同地区

hesicong 272 Dec 24, 2022
geemap - A Python package for interactive mapping with Google Earth Engine, ipyleaflet, and ipywidgets.

A Python package for interactive mapping with Google Earth Engine, ipyleaflet, and folium

Qiusheng Wu 2.4k Dec 30, 2022
3D extension built off of shapely to make working with geospatial/trajectory data easier in python.

PyGeoShape 3D extension to shapely and pyproj to make working with geospatial/trajectory data easier in python. Getting Started Installation pip The e

Marc Brittain 5 Dec 27, 2022
Rasterio reads and writes geospatial raster datasets

Rasterio Rasterio reads and writes geospatial raster data. Geographic information systems use GeoTIFF and other formats to organize and store gridded,

Mapbox 1.9k Jan 07, 2023
Download and process satellite imagery in Python using Sentinel Hub services.

Description The sentinelhub Python package allows users to make OGC (WMS and WCS) web requests to download and process satellite images within your Py

Sentinel Hub 659 Dec 23, 2022
Ingest and query genomic intervals from multiple BED files

Ingest and query genomic intervals from multiple BED files.

4 May 29, 2021
Mmdb-server - An open source fast API server to lookup IP addresses for their geographic location

mmdb-server mmdb-server is an open source fast API server to lookup IP addresses

Alexandre Dulaunoy 67 Nov 25, 2022
A trivia questions about Europe

EUROPE TRIVIA QUIZ IN PYTHON Project Outline Ask user if he / she knows more about Europe. If yes show the Trivia main screen, else show the end Trivi

David Danso 1 Nov 17, 2021
Map Ookla server locations as a Kernel Density Estimation (KDE) geographic map plot.

Ookla Server KDE Plotting This notebook was created to map Ookla server locations as a Kernel Density Estimation (KDE) geographic map plot. Currently,

Jonathan Lo 1 Feb 12, 2022
Stitch image tiles into larger composite TIFs

untiler Utility to take a directory of {z}/{x}/{y}.(jpg|png) tiles, and stitch into a scenetiff (tif w/ exact merc tile bounds). Future versions will

Mapbox 38 Dec 16, 2022
Tools for the extraction of OpenStreetMap street network data

OSMnet Tools for the extraction of OpenStreetMap (OSM) street network data. Intended to be used in tandem with Pandana and UrbanAccess libraries to ex

Urban Data Science Toolkit 47 Sep 21, 2022
Geospatial Image Processing for Python

GIPPY Gippy is a Python library for image processing of geospatial raster data. The core of the library is implemented as a C++ library, libgip, with

GIPIT 83 Aug 19, 2022
GeoNode is an open source platform that facilitates the creation, sharing, and collaborative use of geospatial data.

Table of Contents What is GeoNode? Try out GeoNode Install Learn GeoNode Development Contributing Roadmap Showcase Most useful links Licensing What is

GeoNode Development Team 1.2k Dec 26, 2022
Python module and script to interact with the Tractive GPS tracker.

pyTractive GPS Python module and script to interact with the Tractive GPS tracker. Requirements Python 3 geopy folium pandas pillow usage: main.py [-h

Dr. Usman Kayani 3 Nov 16, 2022
A Jupyter - Leaflet.js bridge

ipyleaflet A Jupyter / Leaflet bridge enabling interactive maps in the Jupyter notebook. Usage Selecting a basemap for a leaflet map: Loading a geojso

Jupyter Widgets 1.3k Dec 27, 2022
Global topography (referenced to sea-level) in a 10 arcminute resolution grid

Earth - Topography grid at 10 arc-minute resolution Global 10 arc-minute resolution grids of topography (ETOPO1 ice-surface) referenced to mean sea-le

Fatiando a Terra Datasets 1 Jan 20, 2022
Geospatial web application developed uisng earthengine, geemap, and streamlit.

geospatial-streamlit Geospatial web applications developed uisng earthengine, geemap, and streamlit. App 1 - Land Surface Temperature A simple, code-f

13 Nov 27, 2022
Build, deploy and extract satellite public constellations with one command line.

SatExtractor Build, deploy and extract satellite public constellations with one command line. Table of Contents About The Project Getting Started Stru

Frontier Development Lab 70 Nov 18, 2022
Open GeoJSON data on geojson.io

geojsonio.py Open GeoJSON data on geojson.io from Python. geojsonio.py also contains a command line utility that is a Python port of geojsonio-cli. Us

Jacob Wasserman 114 Dec 21, 2022