carve_look_at — 3D `space_carving` op

• Data kinds: vector → pose

• Call: import fullseye as fs; fs.ledger.carve_look_at(eye, target=(0.0, 0.0, 0.0), up=(0.0, 0.0, 1.0)) (implementation को सीधे call करना हो तो import visualhull; visualhull.carve_look_at(eye, target=(0.0, 0.0, 0.0), up=(0.0, 0.0, 1.0)), registry से लेना हो तो ops3d.get("carve_look_at"))

उपयोग

carve / synthesize_silhouette को दिया जा सकने वाला camera pose (R, t) बनाता है।

look_at जैसा ही implementation, public layer से पहुँचा जा सकने वाला नाम। 2026-09-08 को जोड़ा गया — उससे पहले space carving का सही pose helper fs. / fs.op. / fs.ledger. में से कहीं से नहीं मिलता था, और fs.op_find("look") भी 0 परिणाम देता था। दूसरी ओर fs.look_at अलग चीज़ है (render3d का gluLookAt संस्करण, 4x4, −Z आगे), इसलिए उसका M[:3,:3] और M[:3,3] देने पर सारे point camera के पीछे चले जाते हैं, और बिना exception के खाली silhouette लौटता है। एक ही नाम और उलटा convention — यह सबसे चुपचाप गलत होने वाला मेल था।

यह वाला OpenCV convention अपनाता है (X_cam = R X + t, +Z आगे, +X दाएँ, +Y नीचे)।

Parameters

eye : (3,) array_like camera का केंद्र (world coordinates)।

target : (3,) array_like देखने का बिंदु (default origin है)।

up : (3,) array_like ऊपर की दिशा (line of sight के लगभग समानांतर हो तो अपने आप वैकल्पिक axis पर बदल जाता है)।

Returns

(R (3,3), t (3,)) synthesize_silhouette(pts, K, R, t, size) को सीधे दिया जा सकता है।

पृष्ठभूमि guides (इस op के पीछे की physics और conventions)

• blender_interop — Blender के साथ उपयोग — shape बनाएँ, fullseye से मापें (सावधानियाँ: axes, units, ground truth)

संदर्भ (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 करते हैं)

• space_carving — py -3.11 examples_3d/space_carving.py

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

fuse_to_voxel · pose_error · bundle_adjust · mean_reprojection_error · optimize_pose_graph · relative_pose · mean_edge_error · rotation_translation_error

इसी category के (`space_carving`)

carve · visual_hull · synthesize_silhouette

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

carve_look_at — 3D space_carving op