OpCaponROIPreprocess.h#
Fully qualified name: public/src/operator/include/OpCaponROIPreprocess.h
In directory: public/src/operator/include
Source file: OpCaponROIPreprocess.h
Capon DoA-on-ROI beamspace-projection preprocessing operator.
Produces the ROI beamspace snapshots and steering vectors consumed by a Capon (MVDR) DoA-on-ROI stage. Runs the beamspace projection on the PVA VPU.
CPU reference: public/samples/radar_processing/capon_roi_preprocess/ref/capon_roi_preprocess_ref.cpp
Note
Create generates and quantizes the DFT twiddle tables (with PVACaponROIPreprocessParams::useCustomTwiddles, Submit quantizes the caller’s). Per detection, every stage runs on the VPU: (1) Doppler window, (2) DDM decode with PVACaponROIPreprocessParams::relDopplerOffset / ddmaWeight, (3) forward-backward averaging, (4) block-float quantization of the virtual-array snapshots, (5) coarse DoA over the beamspace from the element snapshot (direct DFT, or batched FFT-64 with PVACaponROIPreprocessParams::coarseDoAUseFft), (6) ROI selection, (7) azimuth and (8) elevation projection of the ROI, (9) output quantization to Q(inputQBits), and (10) steering-block gather from the LUT. LOCAL Doppler mode only.
Note
Submit reads detectionCount (and waz and wel when PVACaponROIPreprocessParams::useCustomTwiddles is set) through host pointers when it is called, not when the stream reaches it. Those tensors must be host-accessible and fully written before Submit is called, and a previous Submit on the same handle must have completed, since it reuses the handle’s internal buffers. The other inputs are read by the PVA when the stream reaches the work.
Note
Only the first detectionCount detections are processed. The input rows from detectionCount up to maxDet are still transferred by the DMA, so they must be valid memory, but their values are not used and need no padding. The rows of snapshotsROI and steeringVectorsROI from detectionCount up to maxDet are unspecified (they may hold stale data); read only the first detectionCount rows.