IQ Dump behaviour has changed

For those that are storing the IQ recording from there observations I just found out that the behavior has changed. This change comes with the latest Docker master image (creation date 2026-05-21 15:24:18).

ENABLE_IQ_DUMP="True"
IQ_DUMP_FILENAME=/directory/iq_file

Before this change a file would be stored in /directory/iq_file and the next obs would overwrite the file.

The new behavior will store the following file /directory/iq_file_cs16_<DATE-TIME>.raw
People that have a post script that did some changes on the file need to change it.

Other need to take into account that with the new behavior files are no longer replaced and the file system will fill up.

Below a script that is used by me and I guess other also and I changed to take to change into account:

#!/usr/bin/env bash
# suggested variables to set in config
# ENABLE_IQ_DUMP="True"
# IQ_DUMP_FILENAME="/srv/iq"
# IQ_DUMP_RENAME="True"
# IQ_DUMP_COMPRESS="True"

if [[ "${ENABLE_IQ_DUMP^^}" =~ (TRUE|YES|1) ]] && [[ "${IQ_DUMP_RENAME^^}" =~ (TRUE|YES|1) ]]; then
    SAMP=$(${HOME}/bin/find_samp_rate.py "$5" "$6")
    NAME="${IQ_DUMP_FILENAME}_${1}_${2}_${SAMP}.raw"
    mv "${IQ_DUMP_FILENAME}"_cs16_*.raw "${NAME}"
    if [[ "${IQ_DUMP_COMPRESS^^}" =~ (TRUE|YES|1) ]]; then
        # zstd --no-progress --rm -f "${NAME}"
        # tar zcf "${NAME}" "${NAME}".tar.gz --remove-files
        gzip --fast --quiet "${NAME}"
    fi
fi

Jan | PE0SAT

5 Likes

Relevant discussion: https://community.libre.space/t/satnogs-flowgraph-2-4-4-ga91ba984-1-keeps-raw-iq-data/

Maybe make one of these sticky / announcement since this will break stations for anyone who already was using the IQ feature.

2 Likes

I’ve pinned the topic globally for 1 week, l hope this will help with the visibility of this change.

3 Likes

@sdoukos I believe you also mentioned in the satnogs-dev channel that also the audio (ogg) creation function has changed with this update, can you explain the audio creation change?

Looking at recent PHASMA-DIRAC obs I do see that the audio is no longer present.

Jan | PE0SAT

Hello.

Yes the audio file generation has been changed.

Previously we where using the ogg_encoder block from gr-satnogs. This has been replaced with a ZMQ PUB Sink and a python script in satnogs-flowgraphs for subscribing to the publisher and creating the audio file.
The behaviour should be the same, hence if an audio file is not created there is an issue we should explore.

Thanks for the reply @sdoukos,

All PHASMA-DIRAC obs after the image update have no longer a audio recording.

I was under the impression that there was a 48000 baud limit introduced with this new gr-satnogs to satnogs-flowgraph change.

Jan | PE0SAT

Only for the new UNKNOWN mode an audio file would not be available in network. For all others the previous behaviour should occur.

Then sorry to be the messenger of “bad” news as you can see looking at the PHASMA-DIRAC obs, there is no audio being created and/or uploaded.

Jan | PE0SAT

Yes i saw it. I need to test it as I failed to reproduced it locally. Does for other modes work correctly?

Just changing the filter you could have seen that other obs do have an audio recording.

Jan | PE0SAT

@mpalou brought to my attention that the flowgraph for PHASMA does not have an audio sink and never did fsk_phasma_decoder.grc. Observations with audio must run a older flowgraph version that does not use the specific flowgraph but the generic fsk_ax25.grc which has an audio output or some custom flowgraph.

Look at this query you can see that there was/is audio created.

I guess this remark can explain it Previously we where using the ogg_encoder block from gr-satnogs and would raise the question why is the audio creation changed with the new docker image?

Jan | PE0SAT

This is an image of the fsk_phasma_decoder.grc

As you can see there is no audio sink

If someone does not have the satnogs-flowgraphs with at least the release 2.1 won’t run the fsk_phasma_decoder.grc flowgraph but the fsk_ax25.grc which has an audio sink.

So there might exist observations, and still be scheduled new ones, with audio file output but in reality the phasma flowgraph never had an audio output.

1 Like

Thanks for the information.

Jan | PE0SAT