fullseye

vol_profile_line — 3D probe op

使い方

Gray-value profile along the straight probe p0 -> p1.

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.

参考(サンプルデータ・文献)

実行できる例(この op を実際に呼ぶ検証済みサンプル)

型が繋がる次の op(pairs を入力に取れる)

fuse_to_voxel

同カテゴリ(probe)

vol_edge_probe · vol_wall_thickness


Provenance: volprobe.py — 3D operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。

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