dsfb-rf 1.0.1

DSFB-RF Structural Semiotics Engine for RF Signal Monitoring - A Deterministic, Non-Intrusive Observer Layer for Typed Structural Interpretation of IQ Residual Streams in Electronic Warfare, Spectrum Monitoring, and Cognitive Radio
Documentation
+
��i��v�Rt^RIHt^RIt^RIt^RIt^RIHt^RIt	Rt
RtRtRt
]
3RRllt]
3R	R
lltR#)u(
DeepBeam slice generator.

Primary path: ``extract_local_slice`` reads a user-downloaded DeepBeam
HDF5 file (e.g. ``neu_ww72bk394.h5`` from the Northeastern repository
collection ``neu:ww72bh952``) and emits a ≤ 2 MB HDF5 head slice with
the parent's native schema: ``/iq[time,2]``, ``/gain[time]``,
``/rx_beam[time]``, ``/tx_beam[time]``.

Fallback path: ``generate`` — schema-preserving 60 GHz mmWave proxy
(Golay-training + Rician LoS + scatterer + beam-squint) emitted only
when the local file is absent, loudly stamped ``[SYNTHETIC PROXY]``.
)�annotationsN)�Pathi l�)8ic
�,�V^8�dQhRRRRRRRRRR	/#)
��out_binr�out_meta�rngznp.random.Generator�	n_samples�int�return�None�)�formats"�;/home/one/dsfb/crates/dsfb-rf/scripts/gen_proxy_deepbeam.py�__annotate__r sA��8M�8M�
�8M��8M�
�8M��	8M�

�8M�c���\V4p\VP^^44p\VP^^44p\P!.RO\PR7p\P!.RO\PR7p\P
!Wg.^ ,4pVP
.R OVR7P\P4p	VR\VPV4V	RVP%V	RVp
R!pVP^^\P,4p\P!W�^,,4\P!RV,4,p
VP^^\P,4pRpW�,p\VP^^ 44pVV8dFVVR;;;V\P!RV,4,V
RVV,
,,
uuu%\P!R"\P,R,\P!V4,4P\P4pVV,pR#pVPV4P\P 4\P!^4,pVPV4P\P 4\P!^4,pVVVRV,,P\P4,,p\P"!V^,\P R7pVP$P\P 4VR&VP&P\P 4VR&VP)VP+44R	R
RRR
RR\,P.!R\,P0!44R\2R\4RRRVRVRVRR/pVP7\8P:!V^R7R,RR7R#)$�)�dtype��?)�sizeNg333333�?g�h㈵��>:rNr:�Nr�dsfb_rf:provenancezsynthetic-proxyzdsfb_rf:proxy_forz;DeepBeam 60 GHz mmWave dataset (Northeastern neu:ww72bh952)zdsfb_rf:source_modelz^802.11ad-flavoured Golay training + Rician LoS (K=10 dB) + single scatterer + beam-squint rampzdsfb_rf:generated_at�%Y-%m-%dT%H:%M:%SZ�sample_rate_hz�center_frequency_hz�datatypez,cf32 (little-endian interleaved float32 I/Q)r	�
tx_antenna�
rx_antenna�noticezC[SYNTHETIC PROXY] DeepBeam stand-in; not an NI transceiver capture.��indent�
�utf-8��encoding)rrr�����rrr&rrrrr&r&r&rr&)rrrr&rrr&rr&r&r&rrrr&r)r&ry��rg$@y@g\��U�?)r
�integers�np�array�	complex64�concatenate�choice�astype�minr�uniform�pi�sqrt�exp�arange�standard_normal�float32�empty�real�imag�write_bytes�tobytes�time�strftime�gmtime�SAMPLE_RATE�	CENTER_HZ�
write_text�json�dumps)rrrr	�tx_ant�rx_ant�ga�gb�training�data�tx�k_lin�	los_phase�los�
scat_phase�	scat_gain�rx�
scat_delay�squint_ramp�noise_sigma�noise_re�noise_im�cf32�metas&&&&                    r�generaterW s1���I��I�
����a��#�
$�F�
����a��#�
$�F�
���H�PR�P\�P\�	]�B�	���H�PR�P\�P\�	]�B��~�~�r�h��m�,�H��:�:�&�Y�:�7�>�>�r�|�|�L�D�$�%D�s�8�=�=�)�'D�E�D��8�=�=��	
�j�y�	�B�
�E����A�q�2�5�5�y�)�I�
�'�'�%�1�9�%�
&�����Y��)?�
?�C����Q��B�E�E�	�*�J��I�	��B��S�\�\�!�R�(�)�J��I��
�:�;��9�r�v�v�b�:�o�'>�>��D\�i�R\�F\�A]�]�]���&�&��"�%�%��$�.����9�1E�E�F�M�M�b�l�l�[�K�	�k�	�B�"�K��"�"�9�-�4�4�R�Z�Z�@�2�7�7�1�:�M�H��"�"�9�-�4�4�R�Z�Z�@�2�7�7�1�:�M�H�	�k�X��X�
�5�=�=�b�l�l�K�K�	K�B�
�8�8�I��M����4�D�������
�
�+�D��J�������
�
�+�D��J��������'�	�/��Z��!A���
�
�.B�D�K�K�M� R��+��y��B��Y��f��f��W��D�
����
�
�4��2�T�9�G��Lrc
�,�V^8�dQhRRRRRRRRRR/#)	r�src_h5r�out_h5r�n_headr
r�dictr
)rs"rrr[sA��]�]��]��]��]�
�	]�

�]rc�
�^RIp\T4pTP	4'g\RT24h\T4p\T4pTP
TR4;_uu_4p0R'mp\TP44pYx,
p	T	'd\R	T	R
\T4R24hTR,P^,p
\\T4T
4pTR,RTpTR,RTp
TR,RTpTR,RTpRRR4TP
TR4;_uu_4pTPRXR
^R7TPRX
R
^R7TPRXR
^R7TPRXR
^R7RTPR&RTPR&TPTPR&\ P"!4pTP%R4;_uu_4pTP'TP)R(44RRR4TP+4TPR&X
TPR&XTPR&\,P.!R\,P0!44TPR&RTPR&RRR4RRRRRTPR\X
4R\X4RRRRRRRRR /R\,P.!R\,P0!44R!R"/pTP3\4P6!T^R#7R$,R%R&7T# \dp\R4ThRp?ii;i +'giELF;i +'giEL];i +'giL�;i))u
Extract a ≤ 2 MB head slice from a user-downloaded DeepBeam HDF5 file.

Parent schema (established via earlier HTTP Range probe of
``neu_ww72bk394.h5``):
    /iq        float64  shape = (~11B, 2)    gzip chunked
    /gain      float64  shape = (~11B,)      gzip chunked
    /rx_beam   float64  shape = (~11B,)      gzip chunked
    /tx_beam   float64  shape = (~11B,)      gzip chunked

Emits the first ``n_head`` rows of each preserving dtype, yielding a
tens-of-KB head slice with native NI-transceiver provenance.
NzTh5py is required for DeepBeam local slice extraction; install via `pip install h5py`zDeepBeam HDF5 not found: �r�iq�gain�rx_beam�tx_beamz0DeepBeam parent file missing expected datasets: z (have: �)�w�gzip)rH�compression�compression_optszreal-local-filerz[DeepBeam Northeastern repository collection neu:ww72bh952 (user-downloaded HDF5 head slice)zdsfb_rf:sourcezdsfb_rf:parent_file�rbzdsfb_rf:parent_first4MiB_sha256zdsfb_rf:parent_iq_rows_totalzdsfb_rf:head_n_samplesrzdsfb_rf:extracted_atztiq float64 (N,2); gain float64 (N,); rx_beam float64 (N,); tx_beam float64 (N,); NI mmWave transceiver native layoutzdsfb_rf:schemau>DeepBeam (Northeastern neu:ww72bh952) — user-downloaded HDF5u*float64 (N,2) — NI transceiver I/Q pairsu#float64 (N,) — per-sample RF gainu#float64 (N,) — receive beam indexu$float64 (N,) — transmit beam indexrzmReal DeepBeam 60 GHz mmWave head slice; not a benchmark reproduction. Contextual residual-trace exhibit only.r r"r#r$>r_r`rarbi@)�h5py�ImportError�RuntimeErrorr�is_file�FileNotFoundError�File�set�keys�sorted�shaper.r
�create_dataset�attrs�name�hashlib�sha256�open�update�read�	hexdigestr;r<r=r@rArB)rYrZrr[ri�e�src�expected�have�missing�iq_total�nr_r`rarb�f�h�grVs&&&&                r�extract_local_slicer�[s?��&���&�\�F��>�>����";�F�8� D�E�E�
�&�\�F��H�~�H�	
���6�3�	�	�3�7���3�8�8�:����/����B�7�)�L� ��,��q�*��
��t�9�?�?�1�%����F��X�&��
��Y�r��]���6�{�2�A����i�.��!�$���i�.��!�$��
 � 
���6�3�	�	�1�	����B�F�Q��O�	����d��QR��S�	�����f�WX��Y�	�����f�WX��Y�(9����$�%�
0�	
��� �!�*0������%�&��N�N���
�[�[��
�
�!�
�H�H�Q�V�V�O�,�-��56�[�[�]����1�2�2:����.�/�,-����(�)�*.�-�-�8L�d�k�k�m�*\����&�'�
2�	
��� �!�'
 �2	�/��Z��v�{�{�&��H�
� �#�a�&���>��9��<��=�	
�	��
�
�.B�D�K�K�M� R��
6��D�$
����
�
�4��2�T�9�G��L��K��Q���
-�
��	����
 �	�	��:�
�
��
 �	�sJ�L+�%B(M
�/B:M2�)!M	�
B	M2�+M�6M�M�
M	�M/
�)	M2�2N	g8��A)�__doc__�
__future__rrvrAr;�pathlibr�numpyr(�DEEPBEAM_HEAD_Nr>r?�	N_SAMPLESrWr�r
rr�<module>r�sO���#�������� ���	��	��	8M�~"�	]�]r