在 PyVista 中调用 glyph() 时传入 NumPy 数组作为 orient 参数会导致 “truth value of an array is ambiguous” 错误；正确做法是先将向量数据作为字段（field）添加到 PolyData 对象中，再通过字符串名称引用该字段。
在 pyvista 中调用 `glyph()` 时传入 numpy 数组作为 `orient` 参数会导致 “truth value of an array is ambiguous” 错误；正确做法是先将向量数据作为字段（field）添加到 `polydata` 对象中，再通过字符串名称引用该字段。
该错误源于对 pyvista.PolyData.glyph() 方法参数的误解。orient 参数不接受原始 NumPy 数组（如 normed_spins），而仅支持两种类型：
- bool：True 表示使用当前激活的向量数组（需提前设为激活状态）；
- str：指定已存储在 PolyData 中的向量数组字段名（推荐方式）。
因此，关键步骤是：先将向量数据以命名字段形式赋值给 PolyData 实例，再在 glyph() 中通过字符串引用它。
以下是修正后的完整可运行代码：
import numpy as np
import pyvista as pv
cols = 12
rows = 12
spacing = 10.0
# 构建六方晶格点坐标
points = []
for i in range(rows):
for j in range(cols):
x = j * spacing
y = i * (spacing * np.sqrt(3) / 2)
if i % 2 == 1:
x += spacing / 2
points.append([x, y, 0.0])
points = np.array(points)
# 生成并归一化自旋向量（3D 单位向量）
spins = np.random.choice([-1, 1], size=(len(points), 3))
normed_spins = spins / np.linalg.norm(spins, axis=1, keepdims=True) # 更安全的归一化写法
# 创建 PolyData 并注入向量字段
lattice = pv.PolyData(points)
lattice['spin_vectors'] = normed_spins # 字段名可自定义，如 'spin_vectors'
# ✅ 正确调用 glyph：orient 使用字符串字段名
arrows = lattice.glyph(
orient='spin_vectors', # ← 关键：传入字段名而非数组
scale=True,
factor=0.5,
geom=pv.Arrow(), # 显式指定几何体（可选，默认为 Arrow）
)
# 可视化
plotter = pv.Plotter()
plotter.add_mesh(lattice, color="black", point_size=8, render_points_as_spheres=True, label="Lattice Points")
plotter.add_mesh(arrows, color="red", opacity=0.9, label="Spin Arrows")
plotter.show_bounds(grid="front", location="outer", all_edges=True)
plotter.add_legend()
plotter.show(title="Lattice with Oriented Spin Arrows")⚠️ 注意事项：
- np.linalg.norm(..., keepdims=True) 比 [:, np.newaxis] 更清晰且不易出错；
- 确保向量字段维度为 (N, 3)，否则 glyph() 会报维度不匹配错误；
- 若后续需切换不同向量场，只需修改 orient= 后的字符串即可，无需重建 PolyData；
- scale=True 默认按向量模长缩放；若需统一长度，改用 scale=False 或显式传入标量数组。
总结：PyVista 的数据驱动设计要求所有可视化属性（向量、标量、纹理等）必须作为命名字段注册到网格对象中，而非直接传入函数——这是避免此类“ambiguous truth value”错误的核心原则。
