GR_PLOT(1)

✨ NAME ✨

ok so gr_plot — it displays a time series of samples from a file 💖 that's it, that's the whole gig

🦋 DESCRIPTION 🦋

bestie. have you ever captured a bunch of data with the gnuradio file sink and then just… stared at the raw bytes like 👁️👄👁️? yeah. that's what this is for. it shows you data captured using the gnuradio file sink, plotted versus time, and it is lowkey iconic.

here's the usage, verbatim, no notes:

usage: gr_plot [-h]

       [-d {complex64,float32,uint32,int32,uint16,int16,uint8,int8}] [-B
       BLOCK] [-s START] [-R SAMPLE_RATE] FILE [FILE ...]

so what it does: it takes a GNU Radio binary file and displays the samples versus time. periodt. 🎀

you can set the block size to specify how many points to read in at a time, and you can set the start position in the file. those are your two lil knobs. 🎛️

and here's the part that gets people: by default, the system assumes a sample rate of 1, so in time, each sample is plotted versus the sample number. that means your x-axis is literally just "sample 0, sample 1, sample 2…" 🙈 if you want a true time axis, you gotta set the sample rate (-R or --sample-rate) to the sample rate used when capturing the samples. like, the actual one. the real one. not the fake default one. iykyk. ⭐

🌸 positional arguments: 🌸

• FILE — Input file with samples 💅 (yes you can pass more than one, look at the usage line, it says FILE [FILE ...], we love options)

💜 optional arguments: 💜

• -h, --help — show this help message and exit. the classic. the moment. the "wait what does this do again" button 🫶
• -d {complex64,float32,uint32,int32,uint16,int16,uint8,int8}, --data-type {complex64,float32,uint32,int32,uint16,int16,uint8,int8} — Specify the data type [default='complex64']. choose wisely bestie, pick the wrong one and your plot is gonna look like abstract art 😭
• -B BLOCK, --block BLOCK — Specify the block size [default=1000]. how many points it reads in at a time 🍓
• -s START, --start START — Specify where to start in the file [default=0]. skip ahead, main character energy, start wherever you want ✨
• -R SAMPLE_RATE, --sample-rate SAMPLE_RATE — Set the sampler rate of the data [default=1.0]. (yes, it says "sampler rate", we're keeping it exactly as written, don't @ me 💀) set this to your actual capture sample rate and boom, real time axis 🧚

heads up: if you leave -R at its default of 1.0, your x-axis is sample numbers, not seconds. not a bug, just the vibe. set the rate if you want real time. 💖

🌈 SEE ALSO 🌈

go read these too, they're all family 👑

• gr_plot_char(1)
• gr_plot_const(1)
• gr_plot_fft_c(1)
• gr_plot_fft_f(1)
• gr_plot_float(1)
• gr_plot_int(1)
• gr_plot_iq(1)
• gr_plot_psd_c(1)
• gr_plot_psd_f(1)
• gr_plot_qt(1)
• gr_plot_short(1)

ok that's the whole page, mwah 💋 this was gr_plot version 3.8, and the date on it is March 2019 — a whole era, honestly. go plot something pretty. slay 🎀✨🦋