rayd 0.2.3__tar.gz → 0.4.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (181) hide show
  1. {rayd-0.2.3 → rayd-0.4.0}/.github/constraints/drjit-build.txt +1 -1
  2. {rayd-0.2.3 → rayd-0.4.0}/.github/workflows/pypi.yml +1 -1
  3. {rayd-0.2.3 → rayd-0.4.0}/.gitignore +2 -1
  4. rayd-0.4.0/API_RENAME.md +136 -0
  5. rayd-0.4.0/CMakeLists.txt +760 -0
  6. rayd-0.4.0/PKG-INFO +272 -0
  7. rayd-0.4.0/README.md +262 -0
  8. rayd-0.4.0/cmake/embed_ptx.cmake +29 -0
  9. {rayd-0.2.3 → rayd-0.4.0}/examples/README.md +1 -3
  10. rayd-0.4.0/examples/renderer/camera.py +101 -0
  11. rayd-0.4.0/examples/renderer/cornell_box.png +0 -0
  12. {rayd-0.2.3 → rayd-0.4.0}/examples/renderer/cornell_box.py +3 -2
  13. rayd-0.4.0/include/rayd/edge/edge.h +222 -0
  14. {rayd-0.2.3/src/scene → rayd-0.4.0/include/rayd/edge}/edge_bvh.h +24 -0
  15. {rayd-0.2.3/src/scene → rayd-0.4.0/include/rayd/edge}/edge_bvh_config.h +30 -36
  16. rayd-0.4.0/include/rayd/edge/edge_optix_params.h +43 -0
  17. rayd-0.4.0/include/rayd/edge/edge_optix_ptx.h +2106 -0
  18. rayd-0.4.0/include/rayd/edge/scene_edge.h +162 -0
  19. rayd-0.4.0/include/rayd/edge/scene_edge_optix.h +69 -0
  20. rayd-0.4.0/include/rayd/mesh.h +185 -0
  21. rayd-0.4.0/include/rayd/multipath/pipelines.h +90 -0
  22. rayd-0.4.0/include/rayd/multipath/reflection.h +137 -0
  23. rayd-0.4.0/include/rayd/multipath/reflection_accumulation.h +121 -0
  24. rayd-0.4.0/include/rayd/multipath/reflection_accumulation_params.h +111 -0
  25. rayd-0.4.0/include/rayd/multipath/reflection_accumulation_ptx.h +1426 -0
  26. {rayd-0.2.3/src → rayd-0.4.0/include/rayd}/multipath/reflection_dedup.h +7 -0
  27. rayd-0.4.0/include/rayd/multipath/reflection_epc.h +153 -0
  28. rayd-0.4.0/include/rayd/multipath/reflection_epc_field.h +86 -0
  29. rayd-0.4.0/include/rayd/multipath/reflection_epc_params.h +97 -0
  30. rayd-0.4.0/include/rayd/multipath/reflection_epc_ptx.h +2027 -0
  31. {rayd-0.2.3/src → rayd-0.4.0/include/rayd}/multipath/reflection_trace_params.h +18 -4
  32. rayd-0.4.0/include/rayd/multipath/reflection_trace_ptx.h +594 -0
  33. rayd-0.4.0/include/rayd/multipath/segment_visibility.h +92 -0
  34. rayd-0.4.0/include/rayd/multipath/segment_visibility_params.h +58 -0
  35. rayd-0.4.0/include/rayd/multipath/segment_visibility_ptx.h +1483 -0
  36. {rayd-0.2.3/src → rayd-0.4.0/include/rayd}/native_launch_audit.h +24 -7
  37. {rayd-0.2.3 → rayd-0.4.0}/include/rayd/optix.h +56 -12
  38. rayd-0.4.0/include/rayd/ray.h +96 -0
  39. rayd-0.4.0/include/rayd/rayd.h +144 -0
  40. rayd-0.4.0/include/rayd/scene/scene.h +333 -0
  41. rayd-0.4.0/include/rayd/scene/scene_optix.h +97 -0
  42. rayd-0.4.0/include/rayd/transform.h +109 -0
  43. rayd-0.4.0/include/rayd/types.h +163 -0
  44. {rayd-0.2.3 → rayd-0.4.0}/include/rayd/utils.h +38 -0
  45. {rayd-0.2.3 → rayd-0.4.0}/pyproject.toml +4 -7
  46. {rayd-0.2.3/src/scene → rayd-0.4.0/src/edge}/edge_bvh.cu +115 -22
  47. rayd-0.4.0/src/edge/edge_optix.cu +625 -0
  48. {rayd-0.2.3/src/scene → rayd-0.4.0/src/edge}/scene_edge.cpp +796 -548
  49. rayd-0.4.0/src/edge/scene_edge_optix.cpp +837 -0
  50. {rayd-0.2.3 → rayd-0.4.0}/src/mesh.cpp +67 -60
  51. rayd-0.4.0/src/multipath/pipelines.cpp +290 -0
  52. rayd-0.4.0/src/multipath/reflection_accumulation.cu +671 -0
  53. {rayd-0.2.3 → rayd-0.4.0}/src/multipath/reflection_dedup.cu +12 -2
  54. rayd-0.4.0/src/multipath/reflection_epc.cu +671 -0
  55. rayd-0.4.0/src/multipath/reflection_epc_field.cu +491 -0
  56. {rayd-0.2.3 → rayd-0.4.0}/src/multipath/reflection_trace.cu +35 -1
  57. rayd-0.4.0/src/multipath/segment_visibility.cu +263 -0
  58. {rayd-0.2.3 → rayd-0.4.0}/src/native_launch_audit.cpp +4 -1
  59. {rayd-0.2.3 → rayd-0.4.0}/src/optix.cpp +77 -0
  60. rayd-0.4.0/src/rayd.cpp +1400 -0
  61. rayd-0.4.0/src/scene/scene.cpp +4673 -0
  62. {rayd-0.2.3 → rayd-0.4.0}/src/scene/scene_optix.cpp +180 -73
  63. {rayd-0.2.3 → rayd-0.4.0}/tests/baseline_cases.py +9 -45
  64. {rayd-0.2.3 → rayd-0.4.0}/tests/baseline_utils.py +1 -2
  65. rayd-0.4.0/tests/baselines/drjit_v0_4_6/stress/repeated_run_summary.json +4 -0
  66. {rayd-0.2.3 → rayd-0.4.0}/tests/benchmark_edge_bvh_cutoff_compare.py +1 -1
  67. {rayd-0.2.3 → rayd-0.4.0}/tests/benchmark_edge_bvh_pressure.py +1 -1
  68. {rayd-0.2.3 → rayd-0.4.0}/tests/benchmark_edge_bvh_stages.py +0 -7
  69. {rayd-0.2.3 → rayd-0.4.0}/tests/benchmark_edge_queries.py +2 -2
  70. {rayd-0.2.3 → rayd-0.4.0}/tests/benchmark_support.py +2 -2
  71. {rayd-0.2.3 → rayd-0.4.0}/tests/drjit/test_geometry.py +389 -337
  72. rayd-0.4.0/tests/drjit/test_reflection_accumulation.py +244 -0
  73. rayd-0.4.0/tests/drjit/test_reflection_epc.py +870 -0
  74. rayd-0.4.0/tests/drjit/test_visibility_topk.py +435 -0
  75. {rayd-0.2.3 → rayd-0.4.0}/tests/profile_kernel_launches.py +4 -4
  76. rayd-0.4.0/tests/test_project_metadata.py +95 -0
  77. rayd-0.2.3/CMakeLists.txt +0 -394
  78. rayd-0.2.3/PKG-INFO +0 -391
  79. rayd-0.2.3/README.md +0 -379
  80. rayd-0.2.3/cmake/embed_ptx.cmake +0 -11
  81. rayd-0.2.3/docs/api_reference.md +0 -482
  82. rayd-0.2.3/docs/build_optimization.md +0 -71
  83. rayd-0.2.3/docs/edge_bvh_bottleneck_analysis.md +0 -168
  84. rayd-0.2.3/docs/edge_bvh_lbvh_treelet_improvement_plan.md +0 -330
  85. rayd-0.2.3/docs/edge_bvh_optimization_log.md +0 -108
  86. rayd-0.2.3/docs/edge_bvh_stage3_preparation.md +0 -161
  87. rayd-0.2.3/docs/multi_bounce_reflection_trace.md +0 -1046
  88. rayd-0.2.3/docs/performance_benchmark.json +0 -552
  89. rayd-0.2.3/docs/performance_benchmark.png +0 -0
  90. rayd-0.2.3/docs/reflection_trace_gpu_dedup.md +0 -642
  91. rayd-0.2.3/docs/slang_interop.md +0 -231
  92. rayd-0.2.3/examples/basics/camera_edge_sampling_gradient.py +0 -100
  93. rayd-0.2.3/examples/renderer/cornell_box.png +0 -0
  94. rayd-0.2.3/include/rayd/camera.h +0 -172
  95. rayd-0.2.3/include/rayd/constants.h +0 -13
  96. rayd-0.2.3/include/rayd/edge.h +0 -204
  97. rayd-0.2.3/include/rayd/fwd.h +0 -59
  98. rayd-0.2.3/include/rayd/intersection.h +0 -62
  99. rayd-0.2.3/include/rayd/mesh.h +0 -168
  100. rayd-0.2.3/include/rayd/ray.h +0 -34
  101. rayd-0.2.3/include/rayd/rayd.h +0 -22
  102. rayd-0.2.3/include/rayd/reflection.h +0 -120
  103. rayd-0.2.3/include/rayd/scene/scene.h +0 -171
  104. rayd-0.2.3/include/rayd/scene/scene_edge.h +0 -130
  105. rayd-0.2.3/include/rayd/scene/scene_optix.h +0 -69
  106. rayd-0.2.3/include/rayd/slang/interop.h +0 -306
  107. rayd-0.2.3/include/rayd/slang/interop_types.h +0 -189
  108. rayd-0.2.3/include/rayd/slang/rayd.slang +0 -291
  109. rayd-0.2.3/include/rayd/transform.h +0 -96
  110. rayd-0.2.3/include/rayd/types.h +0 -153
  111. rayd-0.2.3/include/rayd_slang.slang +0 -2
  112. rayd-0.2.3/rayd/slang/__init__.py +0 -391
  113. rayd-0.2.3/rayd/torch/__init__.py +0 -57
  114. rayd-0.2.3/rayd/torch/_convert.py +0 -228
  115. rayd-0.2.3/rayd/torch/_env.py +0 -10
  116. rayd-0.2.3/rayd/torch/_interop_patch.py +0 -90
  117. rayd-0.2.3/rayd/torch/_native.py +0 -825
  118. rayd-0.2.3/rayd/torch/_state.py +0 -109
  119. rayd-0.2.3/rayd/torch/_util.py +0 -144
  120. rayd-0.2.3/rayd/torch/camera.py +0 -295
  121. rayd-0.2.3/rayd/torch/mesh.py +0 -184
  122. rayd-0.2.3/rayd/torch/scene.py +0 -406
  123. rayd-0.2.3/rayd/torch/types.py +0 -438
  124. rayd-0.2.3/src/camera.cpp +0 -463
  125. rayd-0.2.3/src/multipath/reflection_trace_host.cpp +0 -229
  126. rayd-0.2.3/src/multipath/reflection_trace_host.h +0 -52
  127. rayd-0.2.3/src/multipath/reflection_trace_ptx.h +0 -464
  128. rayd-0.2.3/src/rayd.cpp +0 -881
  129. rayd-0.2.3/src/scene/experimental/edge_bvh_ploc.h +0 -32
  130. rayd-0.2.3/src/scene/experimental/edge_bvh_ploc_build.inc +0 -685
  131. rayd-0.2.3/src/scene/experimental/edge_bvh_ploc_kernels.inc +0 -377
  132. rayd-0.2.3/src/scene/experimental/scene_edge_ploc.inc +0 -318
  133. rayd-0.2.3/src/scene/scene.cpp +0 -2127
  134. rayd-0.2.3/src/slang_interop.cpp +0 -246
  135. rayd-0.2.3/tests/baselines/drjit_v0_4_6/camera/perspective_fov.json +0 -80
  136. rayd-0.2.3/tests/baselines/drjit_v0_4_6/camera/perspective_intrinsic.json +0 -80
  137. rayd-0.2.3/tests/baselines/drjit_v0_4_6/camera/sample_primary_ray.json +0 -158
  138. rayd-0.2.3/tests/baselines/drjit_v0_4_6/edges/primary_edge_sampling.json +0 -31
  139. rayd-0.2.3/tests/baselines/drjit_v0_4_6/stress/repeated_run_summary.json +0 -5
  140. rayd-0.2.3/tests/slang/__init__.py +0 -0
  141. rayd-0.2.3/tests/slang/cases/load_module_error.py +0 -16
  142. rayd-0.2.3/tests/slang/cases/slang_ad_autograd.py +0 -44
  143. rayd-0.2.3/tests/slang/cases/slang_ad_multi_param.py +0 -51
  144. rayd-0.2.3/tests/slang/cases/slang_ad_optimize.py +0 -52
  145. rayd-0.2.3/tests/slang/cases/slang_ad_struct_return.py +0 -28
  146. rayd-0.2.3/tests/slang/cases/slang_rayd_intersect.py +0 -38
  147. rayd-0.2.3/tests/slang/cases/slang_rayd_nearest_edge.py +0 -71
  148. rayd-0.2.3/tests/slang/shaders/rayd_query.slang +0 -137
  149. rayd-0.2.3/tests/slang/shaders/rayd_query_ad.slang +0 -32
  150. rayd-0.2.3/tests/slang/test_interop.slang +0 -71
  151. rayd-0.2.3/tests/slang/test_slang.py +0 -218
  152. rayd-0.2.3/tests/test_project_metadata.py +0 -25
  153. rayd-0.2.3/tests/test_torch_interop_patch.py +0 -122
  154. rayd-0.2.3/tests/torch/__init__.py +0 -0
  155. rayd-0.2.3/tests/torch/test_edge_bvh_pressure.py +0 -131
  156. rayd-0.2.3/tests/torch/test_geometry.py +0 -2228
  157. {rayd-0.2.3 → rayd-0.4.0}/LICENSE +0 -0
  158. {rayd-0.2.3 → rayd-0.4.0}/examples/basics/nearest_edge_query.py +0 -0
  159. {rayd-0.2.3 → rayd-0.4.0}/examples/basics/ray_mesh_intersection.py +0 -0
  160. {rayd-0.2.3 → rayd-0.4.0}/examples/renderer/README.md +0 -0
  161. {rayd-0.2.3 → rayd-0.4.0}/examples/renderer/rfdt.png +0 -0
  162. {rayd-0.2.3 → rayd-0.4.0}/rayd/__init__.py +0 -0
  163. {rayd-0.2.3 → rayd-0.4.0}/tests/__init__.py +0 -0
  164. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/camera/sample_to_world.json +0 -0
  165. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/camera/world_to_sample.json +0 -0
  166. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/edges/secondary_edges.json +0 -0
  167. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/geometry/batched_hits.json +0 -0
  168. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/geometry/constant_hit.json +0 -0
  169. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/geometry/degenerate.json +0 -0
  170. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/geometry/miss.json +0 -0
  171. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/geometry/multi_mesh.json +0 -0
  172. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/geometry/uv.json +0 -0
  173. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/gradients/transform_gradients.json +0 -0
  174. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/gradients/vertex_gradients.json +0 -0
  175. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/manifest.json +0 -0
  176. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/transforms/composition_left_right.json +0 -0
  177. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/transforms/direction_transform_checks.json +0 -0
  178. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/transforms/matrix_entry_checks.json +0 -0
  179. {rayd-0.2.3 → rayd-0.4.0}/tests/baselines/drjit_v0_4_6/transforms/point_transform_checks.json +0 -0
  180. {rayd-0.2.3 → rayd-0.4.0}/tests/drjit/__init__.py +0 -0
  181. {rayd-0.2.3 → rayd-0.4.0}/tests/drjit/test_baseline.py +0 -0
@@ -1,2 +1,2 @@
1
- drjit==1.2.0
1
+ drjit==1.3.1
2
2
  nanobind==2.9.2
@@ -25,7 +25,7 @@ jobs:
25
25
  python-version: "3.10"
26
26
 
27
27
  - name: Run lightweight unit tests
28
- run: python -m unittest tests.test_torch_interop_patch tests.test_project_metadata -v
28
+ run: python -m unittest tests.test_project_metadata -v
29
29
 
30
30
  build_linux_wheels:
31
31
  name: linux / manylinux_2_28
@@ -22,4 +22,5 @@ unit_test/result/
22
22
  .slangtorch_cache/
23
23
  .rayd_slang_cache/
24
24
  tests/slang/test_interop_gen.cpp
25
- artifacts/
25
+ artifacts/
26
+ docs/
@@ -0,0 +1,136 @@
1
+ # API Rename / Migration Guide
2
+
3
+ Naming cleanup applied on 2026-05-21 (branch `api-naming-cleanup`). Pure renames,
4
+ no functional changes. This document lists every old name and its replacement.
5
+
6
+ ## 1. Naming convention flip (Python)
7
+
8
+ The bare class name is now the **non-AD (detached)** variant — the common case.
9
+ The autodiff variant carries an **`AD`** suffix.
10
+
11
+ ```python
12
+ # before # after
13
+ ray = rd.RayDetached(...) ray = rd.Ray(...) # non-AD
14
+ ray = rd.Ray(...) ray = rd.RayAD(...) # autodiff
15
+ ```
16
+
17
+ This flip is **Python-only**. In C++, aliases keep their existing convention:
18
+ the bare name is still the AD type and the detached type still carries a
19
+ `Detached` suffix (e.g. C++ `Ray` = AD, `RayDetached` = non-AD). The foundational
20
+ `Float` / `Vector*f` / `Matrix4f` aliases are unchanged.
21
+
22
+ ## 2. Python class renames
23
+
24
+ ### Flipped families (each had an AD and a `Detached` variant)
25
+
26
+ | Old (AD) | New (AD) | Old (non-AD) | New (non-AD) |
27
+ |---|---|---|---|
28
+ | `Ray` | `RayAD` | `RayDetached` | `Ray` |
29
+ | `Intersection` | `IntersectionAD` | `IntersectionDetached` | `Intersection` |
30
+ | `ReflectionChain` | `ReflectionChainAD` | `ReflectionChainDetached` | `ReflectionChain` |
31
+ | `ReflectionBounce` | `ReflectionBounceAD` | `ReflectionBounceDetached` | `ReflectionBounce` |
32
+ | `ReflectionTrace` | `ReflectionTraceAD` | `ReflectionTraceDetached` | `ReflectionTrace` |
33
+ | `ReflectionEpcResult` | `ReflectionEpcResultAD` | `ReflectionEpcResultDetached` | `ReflectionEpcResult` |
34
+ | `ReflectionEpcFieldResult` | `ReflectionEpcFieldResultAD` | `ReflectionEpcFieldResultDetached` | `ReflectionEpcFieldResult` |
35
+ | `PrimitiveMaterialPayload` | `MaterialAD` | `PrimitiveMaterialPayloadDetached` | `Material` |
36
+ | `ReflectionWedgeEventBuffer` | `WedgeEventsAD` | `ReflectionWedgeEventBufferDetached` | `WedgeEvents` |
37
+ | `ReflectionAccumulationResult` | `AccumResultAD` | `ReflectionAccumulationResultDetached` | `AccumResult` |
38
+ | `NearestPointEdge` | `NearestPointEdgeAD` | `NearestPointEdgeDetached` | `NearestPointEdge` |
39
+ | `NearestRayEdge` | `NearestRayEdgeAD` | `NearestRayEdgeDetached` | `NearestRayEdge` |
40
+ | `NearestEdgesTopK` | `NearestEdgesTopKAD` | `NearestEdgesTopKDetached` | `NearestEdgesTopK` |
41
+ | `SegmentVisibility` | `SegmentVisibilityAD` | `SegmentVisibilityDetached` | `SegmentVisibility` |
42
+ | `SegmentPairVisibility` | `SegmentPairVisibilityAD` | `SegmentPairVisibilityDetached` | `SegmentPairVisibility` |
43
+ | `AxialEdgeVisibility` | `AxialEdgeVisibilityAD` | `AxialEdgeVisibilityDetached` | `AxialEdgeVisibility` |
44
+ | `SegmentChainVisibility` | `SegmentChainVisibilityAD` | `SegmentChainVisibilityDetached` | `SegmentChainVisibility` |
45
+
46
+ ### Trim-only (single class, no AD/detached pair)
47
+
48
+ | Old | New |
49
+ |---|---|
50
+ | `ReflectionAccumulationGrid` | `AccumGrid` |
51
+ | `ReflectionAccumulationOptions` | `AccumOptions` |
52
+
53
+ Unchanged: `ReflectionTraceOptions`, `ReflectionEpcOptions`, `ReflectionEpcFieldOptions`,
54
+ `RayFlags`, `SecondaryEdgeInfo`, `SceneEdgeInfo`, `SceneEdgeTopology`, `SceneSyncProfile`,
55
+ `SceneEdgeBVHStats`, `Mesh`, `Scene`.
56
+
57
+ ## 3. Method renames (`Scene`)
58
+
59
+ | Old | New |
60
+ |---|---|
61
+ | `trace_segment_visibility(...)` | `visible(...)` |
62
+ | `trace_segment_pair_visibility(...)` | `visible_pair(...)` |
63
+ | `trace_segment_chain_visibility(...)` | `visible_chain(...)` |
64
+ | `trace_axial_edge_visibility(...)` | `visible_axial_edge(...)` |
65
+ | `trace_reflections_accumulating(...)` | `accumulate_reflections(...)` |
66
+ | `trace_reflection_epc_field_direct(tx_position, ...)` | `trace_reflection_epc_field(tx_position, ...)` |
67
+
68
+ `trace_reflection_epc_field_direct` was merged into `trace_reflection_epc_field`
69
+ as an overload: pass a transmitter position (`Vector3f`) as the first argument for
70
+ the direct form, or a `Ray` for the original form.
71
+
72
+ ## 4. Audit dict key (`native_launch_audit()`)
73
+
74
+ | Old key | New key |
75
+ |---|---|
76
+ | `audit["trace_reflections_accumulating"]` | `audit["accumulate_reflections"]` |
77
+
78
+ ## 5. C++ type / symbol renames (for C++ users)
79
+
80
+ Stem trims apply to all variants (`*Data`, `*T`, `*Detached`, and the bare alias):
81
+
82
+ | Old C++ stem | New C++ stem |
83
+ |---|---|
84
+ | `PrimitiveMaterialPayload` | `Material` |
85
+ | `ReflectionWedgeEventBuffer` | `WedgeEvents` |
86
+ | `ReflectionAccumulationResult` | `AccumResult` |
87
+ | `ReflectionAccumulationGrid` | `AccumGrid` |
88
+ | `ReflectionAccumulationOptions` | `AccumOptions` |
89
+ | `ReflectionAccumulationParams` | `AccumParams` |
90
+ | `SceneGlobalGeometry` | `SceneGeometry` |
91
+ | `ReflectionAccumulationRaw` (file-local) | `AccumRaw` |
92
+ | enum `NativeLaunchStage::TraceReflectionsAccumulating` | `NativeLaunchStage::AccumulateReflections` |
93
+ | `NativeLaunchAuditSnapshot::trace_reflections_accumulating` | `::accumulate_reflections` |
94
+
95
+ C++ method renames mirror the Python ones (`Scene::visible`, `Scene::visible_pair`,
96
+ `Scene::visible_chain`, `Scene::visible_axial_edge`, `Scene::accumulate_reflections`,
97
+ and the merged `Scene::trace_reflection_epc_field` overload).
98
+
99
+ ## 6. Quick migration (Python)
100
+
101
+ ```python
102
+ import re, pathlib
103
+
104
+ CLASS = {
105
+ # detached -> bare
106
+ "RayDetached": "Ray", "IntersectionDetached": "Intersection",
107
+ "ReflectionChainDetached": "ReflectionChain", "ReflectionBounceDetached": "ReflectionBounce",
108
+ "ReflectionTraceDetached": "ReflectionTrace",
109
+ "ReflectionEpcResultDetached": "ReflectionEpcResult",
110
+ "ReflectionEpcFieldResultDetached": "ReflectionEpcFieldResult",
111
+ "PrimitiveMaterialPayloadDetached": "Material",
112
+ "ReflectionWedgeEventBufferDetached": "WedgeEvents",
113
+ "ReflectionAccumulationResultDetached": "AccumResult",
114
+ "NearestPointEdgeDetached": "NearestPointEdge", "NearestRayEdgeDetached": "NearestRayEdge",
115
+ "NearestEdgesTopKDetached": "NearestEdgesTopK",
116
+ "SegmentVisibilityDetached": "SegmentVisibility",
117
+ "SegmentPairVisibilityDetached": "SegmentPairVisibility",
118
+ "AxialEdgeVisibilityDetached": "AxialEdgeVisibility",
119
+ "SegmentChainVisibilityDetached": "SegmentChainVisibility",
120
+ # trims (single)
121
+ "ReflectionAccumulationGrid": "AccumGrid",
122
+ "ReflectionAccumulationOptions": "AccumOptions",
123
+ # AD bare -> AD suffix (apply AFTER the detached ones above)
124
+ "PrimitiveMaterialPayload": "MaterialAD",
125
+ }
126
+ METHOD = {
127
+ "trace_segment_pair_visibility": "visible_pair",
128
+ "trace_segment_chain_visibility": "visible_chain",
129
+ "trace_segment_visibility": "visible",
130
+ "trace_axial_edge_visibility": "visible_axial_edge",
131
+ "trace_reflections_accumulating": "accumulate_reflections",
132
+ "trace_reflection_epc_field_direct": "trace_reflection_epc_field",
133
+ }
134
+ # NOTE: the AD bare names that simply gain an "AD" suffix (Ray->RayAD,
135
+ # Intersection->IntersectionAD, etc.) are context-dependent — review those by hand.
136
+ ```