FERS 0.1.0
The Flexible Extensible Radar Simulator
Loading...
Searching...
No Matches
simulationProgressStore.test.ts
Go to the documentation of this file.
1// SPDX-License-Identifier: GPL-2.0-only
2// Copyright (c) 2026-present FERS Contributors (see AUTHORS.md).
3
4import { describe, expect, test } from 'bun:test';
5import {
6 normalizeSimulationOutputMetadata,
7 type RawSimulationOutputMetadata,
8 type SimulationOutputMetadata,
9} from './simulationProgressStore';
10
11const baseMetadata = {
12 schema_version: 1,
13 simulation_name: 'Metadata Fixture',
14 output_directory: '/tmp/fers',
15 start_time: 0,
16 end_time: 1,
17 sampling_rate: 1e6,
18 oversample_ratio: 1,
19} satisfies Omit<SimulationOutputMetadata, 'files'>;
20
21describe('simulation output metadata', () => {
22 test('keeps FMCW metadata and streaming segments', () => {
23 const metadata: SimulationOutputMetadata = {
24 ...baseMetadata,
25 files: [
26 {
27 receiver_id: 10,
28 receiver_name: 'FMCW Rx',
29 mode: 'fmcw',
30 path: '/tmp/fers/fmcw.h5',
31 sampling_rate: 1e6,
32 total_samples: 128,
33 sample_start: 0,
34 sample_end_exclusive: 128,
35 pulse_count: 0,
36 min_pulse_length_samples: 0,
37 max_pulse_length_samples: 0,
38 uniform_pulse_length: true,
39 chunks: [],
40 streaming_segments: [
41 {
42 start_time: 0,
43 end_time: 0.001,
44 sample_count: 128,
45 sample_start: 0,
46 sample_end_exclusive: 128,
47 first_chirp_start_time: 0,
48 emitted_chirp_count: 4,
49 },
50 ],
51 fmcw: {
52 chirp_bandwidth: 20e6,
53 chirp_duration: 250e-6,
54 chirp_period: 500e-6,
55 chirp_rate: 80e9,
56 chirp_rate_signed: -80e9,
57 chirp_direction: 'down',
58 start_frequency_offset: 0,
59 chirp_count: 4,
60 },
61 fmcw_sources: [
62 {
63 transmitter_id: 11,
64 transmitter_name: 'FMCW Tx',
65 waveform_id: 12,
66 waveform_name: 'FMCW Wave',
67 carrier_frequency: 10e9,
68 chirp_bandwidth: 20e6,
69 chirp_duration: 250e-6,
70 chirp_period: 500e-6,
71 chirp_rate: 80e9,
72 chirp_rate_signed: -80e9,
73 chirp_direction: 'down',
74 start_frequency_offset: 0,
75 chirp_count: 4,
76 segments: [
77 {
78 start_time: 0,
79 end_time: 0.001,
80 first_chirp_start_time: 0,
81 emitted_chirp_count: 4,
82 },
83 ],
84 },
85 ],
86 },
87 ],
88 };
89
90 expect(
91 normalizeSimulationOutputMetadata(metadata).files[0]
92 ).toMatchObject({
93 mode: 'fmcw',
94 streaming_segments: [
95 {
96 first_chirp_start_time: 0,
97 emitted_chirp_count: 4,
98 },
99 ],
100 fmcw: {
101 chirp_bandwidth: 20e6,
102 chirp_duration: 250e-6,
103 chirp_period: 500e-6,
104 chirp_direction: 'down',
105 },
106 fmcw_sources: [
107 {
108 transmitter_id: 11,
109 waveform_id: 12,
110 segments: [
111 {
112 first_chirp_start_time: 0,
113 emitted_chirp_count: 4,
114 },
115 ],
116 },
117 ],
118 });
119 });
120
121 test('adapts legacy cw_segments metadata to streaming_segments', () => {
122 const legacyMetadata = {
123 ...baseMetadata,
124 files: [
125 {
126 receiver_id: 20,
127 receiver_name: 'CW Rx',
128 mode: 'cw',
129 path: '/tmp/fers/cw.h5',
130 sampling_rate: 1e6,
131 total_samples: 64,
132 sample_start: 0,
133 sample_end_exclusive: 64,
134 pulse_count: 0,
135 min_pulse_length_samples: 0,
136 max_pulse_length_samples: 0,
137 uniform_pulse_length: true,
138 chunks: [],
139 cw_segments: [
140 {
141 start_time: 0,
142 end_time: 0.001,
143 sample_count: 64,
144 sample_start: 0,
145 sample_end_exclusive: 64,
146 },
147 ],
148 },
149 ],
150 } satisfies RawSimulationOutputMetadata;
151
152 const normalizedFile =
153 normalizeSimulationOutputMetadata(legacyMetadata).files[0];
154
155 expect(normalizedFile.streaming_segments).toHaveLength(1);
156 expect(normalizedFile.fmcw_sources).toEqual([]);
157 expect('cw_segments' in normalizedFile).toBe(false);
158 });
159
160 test('normalizes mixed sampling-rate metadata', () => {
161 const metadata = {
162 ...baseMetadata,
163 sampling_rate: null,
164 sampling_rates: [1e6, 2e6],
165 files: [
166 {
167 receiver_id: 30,
168 receiver_name: 'Rx 1',
169 mode: 'cw',
170 path: '/tmp/fers/rx1.h5',
171 sampling_rate: 1e6,
172 total_samples: 64,
173 sample_start: 0,
174 sample_end_exclusive: 64,
175 pulse_count: 0,
176 min_pulse_length_samples: 0,
177 max_pulse_length_samples: 0,
178 uniform_pulse_length: true,
179 chunks: [],
180 streaming_segments: [],
181 },
182 {
183 receiver_id: 31,
184 receiver_name: 'Rx 2',
185 mode: 'fmcw',
186 path: '/tmp/fers/rx2.h5',
187 sampling_rate: 2e6,
188 total_samples: 128,
189 sample_start: 0,
190 sample_end_exclusive: 128,
191 pulse_count: 0,
192 min_pulse_length_samples: 0,
193 max_pulse_length_samples: 0,
194 uniform_pulse_length: true,
195 chunks: [],
196 streaming_segments: [],
197 fmcw_dechirp_mode: 'none',
198 fmcw_dechirp_reference_source: 'none',
199 },
200 ],
201 } satisfies RawSimulationOutputMetadata;
202
203 const normalized = normalizeSimulationOutputMetadata(metadata);
204
205 expect(normalized.sampling_rate).toBeNull();
206 expect(normalized.sampling_rates).toEqual([1e6, 2e6]);
207 expect(normalized.files.map((file) => file.sampling_rate)).toEqual([
208 1e6, 2e6,
209 ]);
210 });
211
212 test('preserves VITA49 metadata section', () => {
213 const metadata = {
214 ...baseMetadata,
215 files: [],
216 vita49: {
217 endpoint: '127.0.0.1:4991',
218 endpoint_host: '127.0.0.1',
219 endpoint_port: 4991,
220 epoch_unix_nanoseconds: '1700000000123456789',
221 class_id: '0xFA52530001000101',
222 adc_fullscale: 1,
223 max_udp_payload: 1400,
224 queue_depth: 1024,
225 streams: [
226 {
227 receiver_id: 10,
228 receiver_name: 'Rx',
229 stream_id: 1234,
230 sample_rate: 1e6,
231 reference_frequency: 9.6e9,
232 packets_emitted: 4,
233 samples_emitted: 512,
234 packets_dropped: 0,
235 samples_dropped: 0,
236 over_range_count: 0,
237 late_packet_count: 0,
238 context_packet_count: 2,
239 first_sample_time: 0,
240 end_sample_time: 10,
241 first_timestamp: {
242 integer_seconds: 1700000000,
243 fractional_picoseconds: 123456789000,
244 },
245 end_timestamp: {
246 integer_seconds: 1700000010,
247 fractional_picoseconds: 123456789000,
248 },
249 },
250 ],
251 },
252 } satisfies RawSimulationOutputMetadata;
253
254 expect(normalizeSimulationOutputMetadata(metadata).vita49).toEqual(
255 metadata.vita49
256 );
257 });
258});