New software: SatNOGS waterfall tabulation helper

Hi,

[Add introduction to SatNOGS TLE sources, need of doppler measurements, current proposals/plans for timestamped waterfalls here] :laughing:

here I present the waterfall_tabulation_helper.py, a new script to extract rough doppler measurements from SatNOGS waterfall png files. It’s based on my script to extract doppler measurements for Change-4, adjusted to read SatNOGS waterfall pngs and extended to remove the doppler correction performed by the satnogs-client during the observation. It’s purpose is similar to rfplot in STRF. Upon invocation it downloads the waterfall png and obervation metadata and allows the user to extract measurements. Those measurements are then stored in a STRF-compatible file.

Please let me know if you have feedback / ideas!

Best wishes,
Fabian

Example usage

LightSail-2 in observation 806927.

  • Start the helper script with
    satnogs_waterfall_tabulation_helper.py 806927
    
  • Follow the procedures at Data tabulation method

The waterfall including the manually placed markers will look similar to the following:


The extracted markers are saved in an STRF-compatible file (806927.dat).
With rffit the doppler measurements can be compared to TLEs:

These are space-track TLEs (with an epoch near the observation time).

Notes:

  • Frequency-drifted transmitters might not be handled properly at the moment.
  • The script requires a waterfall png from the latest satnogs-client with a bandwidth of 48 kHz. Some observations seem to have waterfalls with different bandwidths.

Edit 2023-01-13:
The software got a new home at Fabian P. Schmidt / Satnogs Waterfall Tabulation Helper · GitLab

Edit 2021-07-05:
This software got a new (temporary) home in the branch pr/tabulation_helper at https://github.com/kerel-fs/strf/tree/pr/tabulation_helper and an User Guide.

16 Likes

Nice work!

Instead of using a site code we should write out the coordinates in the output file. I can adapt rffit from STRF to read those and perform the analysis.

4 Likes

Hi,

I was trying to try this, but ?I’m getting an error on line 87.
print(line, end=’ ’ )
^
Any thought if I have missed a prerequisite?
I’m running a Debian workstation.

Thanks

@Derek Which Python version are you trying to run satnogs_waterfall_tabulation_helper.py with? Seems like you’re trying to run the script with Python 2.x rather than 3.