vol_profile_line — 3D probe op

• Data kinds: voxel → pairs

• Call: import fullseye as fs; fs.ledger.vol_profile_line(vol, p0, p1, n=None, spacing=None, order=1) (implementation को सीधे call करना हो तो import volprobe; volprobe.vol_profile_line(vol, p0, p1, n=None, spacing=None, order=1), registry से लेना हो तो ops3d.get("vol_profile_line"))

• Ledger के ज़रिए return value: fullseye.ledger.vol_profile_line(...) केवल घोषित out type pairs का value लौटाता है (मूल function सहायक जानकारी भी लौटाता है)। जो हिस्सा छोड़ दिया गया है उसकी ज़रूरत हो तो fullseye.ledger.vol_profile_line.raw(...) का उपयोग करें, या volprobe.vol_profile_line को सीधे call करें।

उपयोग

सीधे probe p0 -> p1 के साथ gray-value profile।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

The segment between the two (z, y, x) voxel-space points (fractional coordinates allowed) is sampled at n evenly-spaced positions with spline interpolation of the given order (scipy.ndimage.map_coordinates; 1 = trilinear, the default). n defaults to one sample per unit of *index-space* length (~1 voxel-step resolution regardless of spacing).

Parameters

vol : (D, H, W) array — the volume (float64, finite; fail-closed otherwise).

p0, p1 : (z, y, x) — probe start / end, inside the volume on every axis.

n : int, optional — sample count (>= 2). Default ceil(index_length) + 1.

spacing : (sz, sy, sx) or volio.VolumeMeta, optional — voxel size in mm.

order : int in [0, 5] — interpolation spline order (1 = trilinear).

Returns

(t_mm, values) : two float64 arrays of length n. t_mm[i] is the *physical* distance of sample i from p0 — the cumulative Euclidean norm of the differences of the physical sample coordinates (index * spacing), exact under anisotropic spacing; in plain voxel units when spacing is None. values[i] is the interpolated gray value.

Raises ValueError on a malformed volume, an endpoint outside the volume, coincident endpoints (p0 == p1: no probe direction), n < 2 or an invalid order / spacing.

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

• wall_thickness_probe — py -3.11 examples_3d/wall_thickness_probe.py

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

fuse_to_voxel

इसी category के (probe)

vol_edge_probe · vol_wall_thickness


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

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.