sdf_smooth_union — 3D `sdf_csg` op

• Data kinds: sdf × sdf → sdf

• Call: import fullseye as fs; fs.ledger.sdf_smooth_union(a, b, k) (implementation को सीधे call करना हो तो import sdf_ops; sdf_ops.sdf_smooth_union(a, b, k), registry से लेना हो तो ops3d.get("sdf_smooth_union"))

उपयोग

smooth रूप से गोल किया गया union (polynomial smooth-min)। k>0 पर जोड़ को लगभग k radius से गोल करता है।

Inigo Quilez का quadratic polynomial smin:

h = clip(0.5 + 0.5*(b-a)/k, 0, 1), smin = mix(b,a,h) - k*h*(1-h)।

गुण: (1) symmetric smin(a,b)=smin(b,a), (2) smin <= min(a,b) (जोड़ पर गड्ढा बनता है),

(3) k→0 पर min(a,b) के बराबर (= hard sdf_union), (4) degree 1 का homogeneous

smin(s*a,s*b,s*k)=s*smin(a,b,k) (scale-संगत)।

k दूरी की dimension वाला rounding radius है। hard min चाहिए तो sdf_union का उपयोग करें। ±inf वाले input (esdf के "सब free हो तो +inf" contract के साथ interoperate करते समय) पर blend band |a-b|<k degenerate हो जाता है, इसलिए यह exact min(a,b) लौटाता है। k<=0 पर ValueError raise करता है (0 से भाग से बचने के लिए fail-closed)।

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• render_beauty — py -3.11 examples_3d/render_beauty.py

वे अगले ops जिनसे type जुड़ता है (`sdf` को input के रूप में लेते हैं)

sdf_to_occupancy · fuse_to_voxel · integrate · extract_surface_points · query_distance · sdf_union · sdf_intersect · sdf_subtract

इसी category के (`sdf_csg`)

grid_coords · sphere_sdf · box_sdf · plane_sdf · cylinder_sdf · torus_sdf · capsule_sdf · sdf_union

*Provenance: sdf_ops.py — 3D operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

sdf_smooth_union — 3D sdf_csg op