Mirrors/NawfalMotii79-PLFM_RADAR
1
0
Fork 0
mirror of https://github.com/NawfalMotii79/PLFM_RADAR.git synced 2026-06-10 07:27:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix(gui): PR-Q.4 — per-subframe WaveformConfig + 48-bin parser (C-5)

Browse Source 
Refactor v7.WaveformConfig from single-PRI to PR-Q's 3-PRI staggered
ladder (SHORT 175 us / MEDIUM 161 us / LONG 167 us) and update the
host-side bulk-frame parser dimension to match the FPGA's 48-bin
Doppler output (RP_NUM_DOPPLER_BINS = 48). The parser was rejecting
every production frame with n_doppler != 32, masking the PR-F widening
end-to-end.

WaveformConfig:
- pri_short_s/pri_medium_s/pri_long_s replace single pri_s
- n_doppler_bins 32 -> 48; new num_subframes=3
- Per-subframe velocity_resolution_{short,medium,long}_mps
- Per-subframe max_velocity_{short,medium,long}_mps
- extended_max_velocity_mps_crt(K=6) for 3-PRI alias-resolution ceiling
- Drop pri_s, velocity_resolution_mps, max_velocity_mps (no aliases)

Other:
- radar_protocol.NUM_DOPPLER_BINS 32 -> 48 (NUM_CELLS auto 16384 -> 24576;
  BULK_FRAME_MAX_SIZE flows from NUM_CELLS, no other edits needed)
- v7/dashboard.py constant + stale "(64x32)" title replaced with f-string
- v7/processing.py 32-bin fallback -> 48
- v7/workers.py: derive doppler_center from frame.shape; LONG-PRI v_res
  used as conservative single-PRI placeholder until PR-Q.5 lands the
  CRT extractor (markers in place at both call sites)
- test_v7.py: TestWaveformConfig rewritten (8 tests, per-subframe + CRT
  extension); TestExtractTargetsFromFrame center 16 -> 24

Local tests:
  TestWaveformConfig            8/8 PASS
  TestExtractTargetsFromFrame   6/6 PASS
  test_GUI_V65_Tk             117/0/2 PASS
This commit is contained in:
Jason
2026-05-02 14:33:43 +05:45
parent 7ed4d5d405
commit 71afa96d68
6 changed files with 162 additions and 63 deletions
Download Patch File Download Diff File Expand all files Collapse all files
9_Firmware/9_3_GUI/v7/models.py
+86 -33
View File
@@ -199,56 +199,109 @@ class TileServer(Enum):
class WaveformConfig:
"""Physical waveform parameters for converting bins to SI units.
Encapsulates the radar waveform so that range/velocity resolution
can be derived automatically instead of hardcoded in RadarSettings.
PR-Q (3-PRI staggered ladder, audit C-5 Doppler unfolding):
- SHORT sub-frame: 1 us chirp / 175 us PRI
- MEDIUM sub-frame: 5 us chirp / 161 us PRI
- LONG sub-frame: 30 us chirp / 167 us PRI
Defaults match the AERIS-10 production system parameters from
radar_scene.py / plfm_chirp_controller.v:
100 MSPS DDC output, 20 MHz chirp BW, 30 us long chirp,
167 us long-chirp PRI, X-band 10.5 GHz carrier.
Each sub-frame produces ``chirps_per_subframe`` Doppler bins
(16 → 48 total). Per-subframe v_unamb is ~+/-42 m/s; the host runs
3-PRI Chinese-Remainder unfolding (see PR-Q.5
processing.unfold_velocity_crt) to recover targets out to
``extended_max_velocity_mps_crt``.
"""
sample_rate_hz: float = 100e6 # DDC output I/Q rate (matched filter input)
bandwidth_hz: float = 20e6 # Chirp bandwidth (not used in range calc;
# retained for time-bandwidth product / display)
chirp_duration_s: float = 30e-6 # Long chirp ramp time
pri_s: float = 167e-6 # Pulse repetition interval (chirp + listen)
center_freq_hz: float = 10.5e9 # Carrier frequency (radar_scene.py: F_CARRIER)
n_range_bins: int = 512 # After decimation (3 km mode; 4096 in 20 km)
n_doppler_bins: int = 32 # Total Doppler bins (2 sub-frames x 16)
chirps_per_subframe: int = 16 # Chirps in one Doppler sub-frame
fft_size: int = 2048 # Pre-decimation FFT length
decimation_factor: int = 4 # 2048 → 512
bandwidth_hz: float = 20e6 # Chirp bandwidth (time-bandwidth product / display)
chirp_duration_s: float = 30e-6 # LONG chirp ramp time (longest of the three)
# Per-subframe PRIs (PR-Q stagger; mirrors radar_params.vh
# RP_DEF_{SHORT,MEDIUM,LONG}_LISTEN_CYCLES + chirp cycles).
pri_short_s: float = 175e-6 # SHORT PRI (1 us chirp + 174 us listen)
pri_medium_s: float = 161e-6 # MEDIUM PRI (5 us chirp + 156 us listen)
pri_long_s: float = 167e-6 # LONG PRI (30 us chirp + 137 us listen)
center_freq_hz: float = 10.5e9 # X-band carrier (radar_scene.py F_CARRIER)
n_range_bins: int = 512 # After decimation (3 km mode; 4096 in 20 km)
n_doppler_bins: int = 48 # 3 sub-frames * 16 chirps (matches RP_NUM_DOPPLER_BINS)
chirps_per_subframe: int = 16 # Chirps in one Doppler sub-frame
num_subframes: int = 3 # SHORT, MEDIUM, LONG
fft_size: int = 2048 # Pre-decimation matched-filter FFT length
decimation_factor: int = 4 # 2048 -> 512
# ------------------------------------------------------------------
# Range
# ------------------------------------------------------------------
@property
def range_resolution_m(self) -> float:
"""Meters per decimated range bin (matched-filter pulse compression).
For FFT-based matched filtering, each IFFT output bin spans
c / (2 * Fs) in range, where Fs is the I/Q sample rate at the
matched-filter input (DDC output). After decimation the bin
spacing grows by *decimation_factor*.
Each IFFT output bin spans c / (2 * Fs); after decimation the bin
spacing grows by ``decimation_factor``.
"""
c = 299_792_458.0
raw_bin = c / (2.0 * self.sample_rate_hz)
return raw_bin * self.decimation_factor
@property
def velocity_resolution_mps(self) -> float:
"""m/s per Doppler bin.
lambda / (2 * chirps_per_subframe * PRI), matching radar_scene.py.
"""
c = 299_792_458.0
wavelength = c / self.center_freq_hz
return wavelength / (2.0 * self.chirps_per_subframe * self.pri_s)
@property
def max_range_m(self) -> float:
"""Maximum unambiguous range in meters."""
return self.range_resolution_m * self.n_range_bins
# ------------------------------------------------------------------
# Velocity (per sub-frame)
# ------------------------------------------------------------------
def _v_res(self, pri_s: float) -> float:
c = 299_792_458.0
wavelength = c / self.center_freq_hz
return wavelength / (2.0 * self.chirps_per_subframe * pri_s)
@property
def max_velocity_mps(self) -> float:
"""Maximum unambiguous velocity (±) in m/s."""
return self.velocity_resolution_mps * self.n_doppler_bins / 2.0
def velocity_resolution_short_mps(self) -> float:
"""m/s per Doppler bin in the SHORT sub-frame."""
return self._v_res(self.pri_short_s)
@property
def velocity_resolution_medium_mps(self) -> float:
"""m/s per Doppler bin in the MEDIUM sub-frame."""
return self._v_res(self.pri_medium_s)
@property
def velocity_resolution_long_mps(self) -> float:
"""m/s per Doppler bin in the LONG sub-frame."""
return self._v_res(self.pri_long_s)
@property
def max_velocity_short_mps(self) -> float:
"""Per-subframe SHORT v_unamb (+/-)."""
return self.velocity_resolution_short_mps * self.chirps_per_subframe / 2.0
@property
def max_velocity_medium_mps(self) -> float:
"""Per-subframe MEDIUM v_unamb (+/-)."""
return self.velocity_resolution_medium_mps * self.chirps_per_subframe / 2.0
@property
def max_velocity_long_mps(self) -> float:
"""Per-subframe LONG v_unamb (+/-)."""
return self.velocity_resolution_long_mps * self.chirps_per_subframe / 2.0
def extended_max_velocity_mps_crt(self, max_alias_k: int = 6) -> float:
"""CRT-extended unambiguous velocity ceiling (PR-Q C-5).
Three coprime PRIs let the host resolve aliases up to
``max_alias_k`` folds before the alias set itself becomes
ambiguous. Returns the velocity beyond which detections must
be flagged AMBIGUOUS even after CRT unfolding.
Ceiling is set by the largest per-subframe v_unamb (smallest
PRI) times the alias search depth. For PR-Q stagger
(175/161/167 us) with K=6 the practical ceiling is ~266 m/s,
well above typical UAS speeds (50-80 m/s).
"""
v_unamb = max(
self.max_velocity_short_mps,
self.max_velocity_medium_mps,
self.max_velocity_long_mps,
)
return v_unamb * max_alias_k