Waterfall

Beschreibung

Mithilfe erwünscht! Wer kann/will hier Informationen beisteuern? Bitte Info per Mail.

waterfall ist ein Tool um aus einer IQ Datei bzw. einer Pipe ein Wasserfalldiagramm zu erstellen. "Max-Hold" Wasserfall um auch lange Zeiträume in einem Wasserfallbild darzustellen.

Dieses Tool wird beim SDR-Buffer benutzt
https://wiki.oevsv.at/wiki/SDR-Buffer
https://websdr.iks.tugraz.at/sdrbuffer/

Beispiel: ./waterfall-x64 -i /media/DUMP/20200915/1256 -o 400 -C -w test.png -x 1600 -y 5 -j 65000 -b 17 -d -c col.txt -z 85

Um das selbe Ergebnis mit unterschiedlichen input Bandbreiten zu erhalten, müssen die Werte bei den Parametern -j und -b angepasst werden.

Varianten

• waterfall
• waterfall3
• waterfall.py

waterfall

Übersicht der Parameter

waterfall -h
 Make Waterfall image out of IQ-File
 -b <brightness>    gain (20.0)
 -c <file>          read colour lines "<index> <r> <g> <b>" (0..255) gaps interpolated
                      for colours testimage start without -i
 -h                 this
 -f u8|i16          IQ data format
 -i <file>          IQ-filename
 -j <samples>       jump to next position in IQ-file in samples (default read all samples)
 -j <ms>            in roll-mode (-r) wait ms till next subsample taken from near eof
                      next image written in this time*oversample at system clock second change
                      on system clock jump max. 60s will be filled or left out
 -m                 mirror image vertical
 -o <n>             oversample <n> times with peak-hold before draw next line (1)
                      if -r and IQ-file is a pipe: -o seconds/line -j samples/line
 -r                 roll-mode with image line from last position of (growing) IQ-file
                      IQ-file may be removed/rewritten any time
 -t                 unfilled part of image is transparent
 -w <file>          waterfall image png in roll mode written every new line
 -x <pixel>         image x-size, prefer 2^n for no pixel interpolation
 -y <pixel>         image y-size, if not -r default as filesize
 -Z <%>             threshold for blacklevel in % of pixels/line below black (10)
 -z <level>         manual noisefloor blacklevel, 0.0 for automatic (0.0)

waterfall3

waterfall3 ist das Gleiche wie waterfall, jedoch mit libfftw3 verlinkt, da es je nach CPU bis zu 2x so schnell arbeitet.

Übersicht der Parameter

waterfall3 -h
 Make Waterfall image out of IQ-File
 -b <brightness>    gain (20.0)
 -C                 combine median and peak of "-o" lines
 -c <file>          read colour lines "<index> <r> <g> <b>" (0..255) gaps interpolated
                      for colours testimage start without -i
 -d                 ADC DC-offset filter on
 -h                 this
 -f u8|i16          IQ data format
 -i <file>          IQ-filename
 -j <samples>       jump to next position in IQ-file in samples (default read all samples)
                      to see samples attenuated by window function too, set to less than "-x"
 -j <ms>            in roll-mode (-r) wait ms till next subsample taken from near eof
                      next image written in this time*oversample at system clock second change
                      on system clock jump max. 60s will be filled or left out
 -M                 make median of "-o" lines before draw it, default peak-hold
 -m                 mirror image vertical
 -o <n>             oversample <n> times with peak-hold before draw it (1)
                      if -r and IQ-file is a pipe: -o seconds/line -j samples/line
 -r                 roll-mode with image line from last position of (growing) IQ-file
                      IQ-file may be removed/rewritten any time
 -t                 unfilled part of image is transparent
 -w <file>          waterfall image png in roll mode written every new line
 -x <pixel>         image x-size, prefer 2^n for no pixel interpolation
 -y <pixel>         image y-size, if not -r default as filesize
 -Z <%>             threshold for blacklevel in % of pixels/line below black (10)
 -z <level>         manual noisefloor blacklevel, 0.0 for automatic (0.0)

waterfall.py

waterfall.py ist ein Pythonskript und erstellt ein Wasserfalldiagramm für den Wettersondenempfang. Weitere Informationen zu diesem Skript findet man auf der eigenen Seite des Skripts waterfall.py

col.txt

 0 0 0 0
 64 0 0 255
 128 0 255 0
 192 255 255 0
 255 255 0 0

• die erste Spalte definiert den Schwellwert für diese Zeile (0-255)
• die 2. bis 4. Spalte definieren die Farbe in R-G-B ebenfalls 0-255