directTDoA screenshot

   To Install and run, please consider this git repository :
   
   https://github.com/llinkz/directTDoA
   
   and refer to here for the installation
   
   Here are some TDoA runs i've made so far using the GUI : runs
   
   Here are the code evolution screenshots : screenshots
	
###############################################################################################################################################
#                                                                                                                                             #
# This piece of software is JUST a GUI written for Python 2.7 designed to compute TDoA maps with GPS enabled KiwiSDR servers around the world #
# It uses the EXCELLENT work of Christoph Mayer @ https://github.com/hcab14/TDoA                                                              #
#    + his forked "kiwiclient" python scripts (original code by Dmitry Janushkevich @ https://github.com/dev-zzo/kiwiclient)                  #
#                                                                                                                                             #
###############################################################################################################################################


#  ####### LICENSE #######
#
# This python GUI code has been written and released under the "do what the f$ck you want with it" license
# This program should work fine on Linux and MacOS


#  ####### WARNING #######
#
# This code may contain some silly procedures and dumb algorithms as I'm not a python guru, but it almost works so...
# This code is not optimized at all as well, will try to do my best during free time...



# ####### CHANGE LOG #######
#
# v1.00-1.50: first working version, basic, static map, manual host adding, hardcoded coordinates, manual octave code run etc...
# v2.00: current work, update & dynamic maps full of GPS enabled nodes, auto octave code run, easier to use
# v2.10beta: adding differents maps that can be choosed by the user, early work on SNR and tiny waterfall for nodes
# v2.20: adding favorite/blacklist node management, popup menu when clicking a node gives: add for TDoA proc + Open KiwiSDR in browser
# v2.30: adding node color change + warning if TDoA map boundaries are not set + final pop-up at the end of process with most likely coords
# v2.31: bugfix on checkfilesize process
# v2.32: adding a restart GUI button
# v2.33: adding MacOS X compatibility, thx Nicolas M.
# v2.40: known points (world capitals) listing is now a file, format is 'name,lat,lon' - easier for you to add yours :-)
# v2.41: update process modified due to missing tags for some nodes in kiwisdr.com/public page
# v2.42: forgot some conditions for MacOS compatibility oops thanks Nicolas M. again :-)
# v2.43: auto create the directTDoA_server_list.db file at 1st start, file does not need to be in the repo anymore
# v2.44: code cleanup + adding a warning about missing GPS timestamps in IQ recordings + removing ugly maps + adding new kickass NASA maps
# v2.50: some TODO items have been coded ot fixed
# v2.60: map update now based on John's json listing + GPS fix/min map filter + nodes are identified by IDs, no hosts anymore + no .png file creation (patch) + no more gnss_pos.txt backup and no more TDoA/gnss_pos/ purge
# v2.70: Octave subprocess management modified (no more octave defunct remaining in "ps aux" now) + stdout & stderr saved in the same "TDoA/iq//TDoA_.txt" file
# v2.71: Color points (nodes) change in brightness according to the number of GPS fix/min, minimum=0  maximum=30 (version not released)
# v2.72: Adding the SNR values of each node from linkfanel's (JSON) database + Color points (nodes) change in brightness according to the SNR, minimum=0  maximum=35? (version not released)
# v2.80: Listing update is now made from both linkfanel's (JSON) databases only (GPS enabled nodes list + SNR values) + adding regexp to create TDoA_id (parsing callsigns), IPs and node various coordinates format (version not released)
# v2.90: Code clean-up + SNR values are now only from IS0KYB (JSON) database + count TDoA runs at start + adding a ./recompute.sh script to backup dir + directTDoA node db now in JSON format - (dev in progress)
# v3.00: More code clean-up and as the GUI has changed a lot recently, it's now entering the v.3xx version range

# ####### TODO LIST #######
#
# offline tool to re-compute the backup IQ files more easily ?
# ultimateTDoA variant mode ? (c)Daniel Ekmann, to basically record all possible nodes at same time in order to post-compute TDoAs later with a dynamic .m file
# securizing the node.db.bak in case of multiple faulty update processes
# adding more error triggers in case of faulty update process or failed connections to node (bad password / node is busy)
# compute mini-waterfall pictures & SNR measurements on selected nodes if necessary (directly in python, not via jupyther notebook stuff)
# merging a part of the directKiwi code to connect & get the audio stream from the selected nodes (faster than the webconnect to openwebrx interface)


Enjoy

linkz
September 2018