# IQ Spectrum Waterfall Packager Local source edition 1.0.0. Turn a short signed 8-bit complex bench recording into a time-frequency waterfall and calibrated digital-bin measurements for signal review. ## Run locally Extract the complete ZIP. Use Python 3.12 from a terminal in the extracted directory. Create a virtual environment and activate it, then run: python -m pip install -r requirements.txt python run.py example.json results Use a new output folder for each run. Start with example.json and replace its synthetic values with your own data. Preserve field names, types and units. Files and reports are processed on your computer. ## Inputs Supply iqBase64 containing raw signed interleaved ci8 samples (I then Q, scaled by 128), integer sampleRateHz, centerHz and fftSize (256, 512 or 1024). Provide from one full window up to 262144 complex samples with constant tuning and sampling rate. Buyer-owned bench or synthetic captures only. Upload the sample bytes, not a container or device identifiers. ## Results WATERFALL.png maps frequency left to right and time top to bottom. Each row is one non-overlapping periodic Hann window, width fftSize; row duration is fftSize/sampleRateHz. Black is at or below -100 dBFS; white is at or above 0 dBFS. SPECTRUM.csv gives mean linear power converted to dBFS and peak power per bin, floored at -120 dBFS. A bin-centered unit complex tone is the amplitude reference. These are relative digital levels, not RF power in dBm. The summary reports unused tail samples. The results folder includes summary.json and the output files produced by this input. The sample produces: WATERFALL.png, SPECTRUM.csv. ## Español · Analizador espectral de muestras IQ Transforma una grabación IQ corta en un diagrama de cascada e informa las mediciones de sus bandas de frecuencia. Extrae el ZIP completo y abre una terminal en esa carpeta con Python 3.12. Crea y activa un entorno virtual e instala las dependencias con el comando anterior. Ejecuta: python run.py example.json resultados Copia example.json para preparar tus datos. Conserva los nombres y tipos de los campos, usa una carpeta de salida nueva y consulta summary.json junto con los archivos generados. La descripción detallada de los campos está en inglés. The included LICENSE covers use and modification for your own personal and commercial projects. This edition includes its source and can run locally after setup.