Rename sim_radar debug parameter to dry_run

Rename the sim_radar boolean flag from `debug` to `dry_run` across the Cython API and header, update the docstring to describe dry-run behavior, and pass the new parameter to the underlying extern call. Remove explicit `debug=False` usages in tests so they rely on the new default. Modified files: src/radarsimpy/includes/radarsimc.pxd, src/radarsimpy/simulator_radar.pyx, tests/test_system_fmcw_radar.py, tests/test_system_interference.py.

Author: rookiepeng

src/radarsimpy/includes/radarsimc.pxd

@@ -334,7 +334,7 @@ cdef extern from "simulator_mesh.hpp":
                               Vec2[int_t] ray_filter,            # Ray index filter [min, max]
                               bool back_propagating,             # Enable back-propagation
                               string log_path,                   # Debug log file path
-                              bool debug)                        # Enable debug output
+                              bool dry_run)                      # Enable dry run mode
 
 # Radar Interference Simulation
 # Radar-to-radar interference simulation for EMC analysis

src/radarsimpy/simulator_radar.pyx

@@ -143,10 +143,10 @@ cdef inline raise_err(RadarSimErrorCode err):
 @cython.boundscheck(False)
 @cython.wraparound(False)
 cpdef sim_radar(radar, targets, density=1, level=None, interf=None,
-                ray_filter=None, back_propagating=False, device="gpu", log_path=None, debug=False):
+                ray_filter=None, back_propagating=False, device="gpu", log_path=None, dry_run=False):
     """
     sim_radar(radar, targets, density=1, level=None, interf=None, ray_filter=None,
-              back_propagating=False, device="gpu", log_path=None, debug=False)
+              back_propagating=False, device="gpu", log_path=None, dry_run=False)
 
     Simulates the radar's baseband response for a given scene.
 
@@ -214,9 +214,9 @@ cpdef sim_radar(radar, targets, density=1, level=None, interf=None,
             use a module compiled without GPU support.
     :param str or None log_path:
         Path to save ray-tracing data. Default: ``None`` (does not save data).
-    :param bool debug:
-        Whether to enable debug mode. When enabled, additional debug information will be printed
-        during the simulation process. Default: ``False``.
+    :param bool dry_run:
+        Whether to enable dry run mode. When enabled, the simulation will skip actual ray tracing
+        while still performing setup and validation. Default: ``False``.
 
     :return:
         A dictionary containing the simulated baseband response and related data:
@@ -420,7 +420,7 @@ cpdef sim_radar(radar, targets, density=1, level=None, interf=None,
             ray_filter_c,
             back_propagating,
             log_path_c,
-            debug)
+            dry_run)
         if err:
             raise_err(err)
     else:
@@ -438,7 +438,7 @@ cpdef sim_radar(radar, targets, density=1, level=None, interf=None,
             ray_filter_c,
             back_propagating,
             log_path_c,
-            debug)
+            dry_run)
         if err:
             raise_err(err)
 

tests/test_system_fmcw_radar.py

@@ -652,7 +652,7 @@ def test_fmcw_raytracing_radar_rotation():
 
     targets = [target_1]
 
-    data = sim_radar(radar, targets, density=1, level="pulse", debug=False)
+    data = sim_radar(radar, targets, density=1, level="pulse")
 
     baseband = data["baseband"]
 
@@ -721,7 +721,7 @@ def test_fmcw_raytracing_radar_speed():
 
     targets = [target_1]
 
-    data = sim_radar(radar, targets, density=1, level="pulse", debug=False)
+    data = sim_radar(radar, targets, density=1, level="pulse")
 
     baseband = data["baseband"]
 

tests/test_system_interference.py

@@ -81,7 +81,7 @@ def test_scene_interference():
 
     targets = [target_1]
 
-    data = sim_radar(radar, targets, density=0.2, debug=False, interf=int_radar)
+    data = sim_radar(radar, targets, density=0.2, interf=int_radar)
 
     inc_bb = data["interference"]