Tutorial / Tricks to Enhance Signal Clarity in the Waterfall with ARTIFACT .H5 and little introduce to STRF

Maybe among you, there’s some curiosity about the function of the artifact, or the .h5 file present on this observation.

artifact

Its function is to display waterfall results in a more detailed, sharp, and interactive way. Weak signal traces that might not be visible in the waterfall can be clearly seen using this feature. Maybe same function like inspectrum

However, this function is not enabled by default. As the station owner, you need to activate it. Please edit your station config file, or in satnogs-setup, and look for the variable, and enable it:

SATNOGS_ARTIFACTS_ENABLED=True
SATNOGS_ARTIFACTS_API_TOKEN=xxxx

to get the api token, you must first create account at https://db.satnogs.org,
login and click avatar, Settings / API Token

after change, dont forget to restart the station and make a new observation.

here example how to use this artifact / .h5 feature:

  1. open this observation

  2. download artifact .h5

  3. open SatNOGS Artifacts Waterfall Viewer

  4. upload .h5 file, and you will see this:

  5. adjust the dB, for example +42dB and +18dB to make signal clear

  6. click on + for zoom in, and - for zoom out, and Fit to reset
    if you move the cursor inside waterfall, a tooltip will shown frequency offset and time in seconds

  7. look at [add local noise], and set for example frequency offset: -21. click overlay. This feature helps you identify signals in the waterfall that belong to terrestrial signals (red line) not satellite.

  8. [add a second object], you can put TLE here.
    for example put an old tle, to compare with the new tle . just copy the tle below and paste in the box.

LAPAN-A2                
1 40931U 00000    25335.25024306  .00000000  00000-0 -12415-2 0    06
2 40931   5.9993 146.8001 0011522  76.2373  62.4970 14.78985243  4354

or to check if the TLE used in this observation is accurate:

LAPAN-A2
1 40931U          25344.45049596  .00000000  00000-0  30000-3 0    06
2 40931   6.0006  76.1618 0012733 338.8432 322.8531 14.79075522    03

in this example i put -2.8 for frequency offset. you adjust this to make line at center of freq (0.00)


Finally, you can also use this artifact to create TLE using the STRF tools.

To do this:

  1. Click on each signal peak in the waterfall. Each dot you click will appear in the [frequency measurements] table. Once you’re done, click the [Download (STRF-compatible file] button.

  2. edit measurements.dat file with your fav text editor, and replace the site location 9999 with your obs station id. for example in this obs, the station id is 4330.

  3. open the file with strf using this command:
    ./rffit -d measurements.dat -i 40931 -c lapan-a2_2025-12-10_v1.txt

measurements.dat (455 Bytes)
sites.txt (809 Bytes)
lapan-a2_2025-12-10_v1.txt (149 Bytes)

thank you for @cgbsat and @kerel and satnogs-client teams for great tools used in this tutorial

10 Likes

Great info - thanks! I’ve already been wondering what’s in the .h5 :wink:

73, stefan/oe6isp

1 Like

are there any recommendations, how to set up rffit? I coudnt get a clean install so far, tried on Ubuntu 20 and 24 without success. There are always issues related to fortran.

Below links to STRF information and this will be a steep curve but you will learn a lot.

Jan | PE0SAT

4 Likes

Thanks a lot Jan, for this detailed information. I know thats hardcore-stuff and needs some hours to study - and that’s why it is so interesting :slight_smile:

73, Stefan

1 Like

maybe it help:
sudo apt install git make gcc pgplot5 gfortran libpng-dev libx11-dev libgsl-dev libfftw3-dev libsox-dev dos2unix

or if you open a .dat file with rffit, and there error, maybe you can check and open the .dat file with text editor, and look if there are broken line there

2 Likes

Thx! this solved the installation problem on UBUNTU 20.

2 Likes

another example, comparasion between waterfall .png vs artifact .h5
from this observation

1 Like