texture op• 数据种类:image → image
• 调用:fullseye.apply(img, "structure_tensor_orientation", a=0.5, b=0.5)(2-D 的模型是一张图 + 两个标量旋钮 a,b∈[0,1])

*图为在 128×128 合成输入上实际运行的输出。左为输入,右为输出。点云以俯视散点显示(亮度 = z),一维序列为折线,体数据为沿 z 的最大值投影,视频为中间帧,复数图像为幅值;无法成像的返回值直接显示数值。*
*输出以类 viridis 伪彩色显示(深紫 = 小,黄 = 大),便于读取距离、相位、方向、深度这类“量的场”。*
扫描旋钮 a(0.1 / 0.5 / 0.9,另一旋钮取默认):
▸ structure_tensor_orientation: 旋钮 a 扫描 (文档网站)
扫描旋钮 b(0.1 / 0.5 / 0.9,另一旋钮取默认):
▸ structure_tensor_orientation: 旋钮 b 扫描 (文档网站)
换别的图像(合成场景 / 照片 / 硬币。上排为输入,下排为对应输出。旋钮取默认):
▸ structure_tensor_orientation: 其他输入图像 (文档网站)
*第 4 列是彩色 (H,W,3) 输入。此算子能正确处理颜色而不跨通道(不把颜色通道当作第三个空间轴卷积)。*
返回局部条纹走向(结构张量的主轴),并映射到 [0,1]。
0 和 1 都对应水平,0.5 对应垂直(方向每 180 度绕一周,因此 0 和 1 是同一方向 —— 请注意对该输出做差分会在接缝处出现虚假的阶跃)。
a 是求导前的平滑 sigma(0.5〜3.0 像素),b 是积分窗口 rho(1.0〜8.0 像素)。rho 表示“在多大范围内视为方向一致”,应取得比纤维或研磨痕的间距更大。
适用条件:方向只在梯度存在结构性偏向的地方才能定义。张量的各向异性相对于迹低于 1e-6 的像素(平坦面、各向同性噪声)作为“方向未定义” 返回 0.5 —— 若这里不设下限,均匀面上的舍入残渣会被 arctan2 放大,亮度仅改变 0.01 方向就会一齐反转。方向的可信度请另用 structure_tensor_coherence 测量。
用途:纤维增强材料的纤维取向、轧制/研磨的条痕方向、木纹、晶粒的伸长方向。HALCON 中没有对应的单体 op。
• gallery2d_texture_freq 族使用指南
• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• 算法的正典(作者、年份)与用途见上面的族使用指南。
下面的程序已确认可以运行(与图相同的输入)。在 Studio 帮助中,此块会变成按钮,可当场加载并运行。
structure_tensor_orientation 0.50 0.50
• degenerate_inputs — py -3.11 examples/degenerate_inputs.py
• gallery2d_texture_freq — py -3.11 examples/gallery2d_texture_freq.py
image 作为输入)identity · gaussian · mean_box · bilateral · unsharp · median · min_filter · max_filter
texture)std_filter · local_bimodality · local_std · scale_select_std · bootstrap_std_error · structure_tensor_coherence · gabor · sk_frangi
*Provenance: ops.py — 2D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.