本文详解如何通过合理设置坐标轴范围与 nan 掩码协同使用，避免因自动缩放导致的圆柱几何形变，实现对圆柱表面（如管道）特定角度区段（如仅保留前25°）的干净、无畸变遮蔽。
本文详解如何通过合理设置坐标轴范围与 nan 掩码协同使用，避免因自动缩放导致的圆柱几何形变，实现对圆柱表面（如管道）特定角度区段（如仅保留前25°）的干净、无畸变遮蔽。
在 Plotly 中绘制三维圆柱面时，若直接用 np.nan 掩蔽部分数据（例如按角度剔除 θ > 25° 的区域），常出现表面扭曲、截断不齐或“塌陷”现象。根本原因并非掩码逻辑错误，而是 Plotly 默认的自动坐标轴范围（auto-range）会随有效数据边界动态收缩——被 np.nan 覆盖的区域导致 x.min()/y.min() 等统计值偏移，进而压缩视图范围，使剩余圆弧段被强行拉伸或挤压，破坏圆柱的几何保真度。
✅ 正确解法：显式固定场景坐标轴范围（scene.xaxis.range, scene.yaxis.range, scene.zaxis.range），确保无论是否掩码，视图始终基于完整圆柱的理论边界渲染。
以下为优化后的完整实现：
import plotly.graph_objects as go
import numpy as np
mask_cylinder = True # 启用角度遮蔽
# 构建参数网格
theta = np.linspace(0, 2 * np.pi, 100) # 完整角度范围：0–360°
z = np.linspace(0, 10, 100) # 轴向高度
theta_grid, z_grid = np.meshgrid(theta, z)
r = 1.0
# 生成圆柱坐标
x = r * np.cos(theta_grid)
y = r * np.sin(theta_grid)
# 计算完整圆柱的理论边界（关键！）
xlim = (x.min(), x.max()) # 理论上：(-1, 1)
ylim = (y.min(), y.max()) # 理论上：(-1, 1)
zlim = (z.min(), z.max()) # 理论上：(0, 10)
# 添加小幅 padding 防止边缘锯齿或裁剪
def pad_limits(min_val, max_val, padding_factor=0.05):
range_val = max_val - min_val
padding = range_val * padding_factor
return min_val - padding, max_val + padding
xlim = pad_limits(*xlim)
ylim = pad_limits(*ylim)
zlim = pad_limits(*zlim)
# 应用角度掩码（例如仅保留 [0°, 25°] 区段）
if mask_cylinder:
mask = theta_grid > np.deg2rad(25) # 注意：deg2rad 转换，且逻辑为“排除大于25°”
x = np.where(mask, np.nan, x)
y = np.where(mask, np.nan, y)
z = np.where(mask, np.nan, z_grid) # 仅 z 使用原始 z_grid，避免引入额外 NaN
else:
z = z_grid
# 绘图
fig = go.Figure()
fig.add_trace(go.Surface(
x=x, y=y, z=z,
colorscale="Viridis",
showscale=True,
lighting=dict(ambient=0.6, diffuse=0.8) # 可选：增强立体感
))
fig.update_layout(
title="3D Pipe with Angular Masking (0°–25° only)",
scene=dict(
xaxis_title="X",
yaxis_title="Y",
zaxis_title="Z",
xaxis=dict(visible=True, range=xlim, showgrid=True),
yaxis=dict(visible=True, range=ylim, showgrid=True),
zaxis=dict(visible=True, range=zlim, showgrid=True),
# 可选：启用旋转约束提升交互体验
aspectmode='data' # 保持真实长宽高比例
),
margin=dict(l=0, r=0, b=0, t=60)
)
fig.show()
? 关键要点说明：
-
range参数是核心：必须基于未掩码前的完整数据极值（x.min()/max()等）计算，并添加 padding，而非依赖掩码后数据的统计值； -
掩码一致性：
x,y,z三者需使用同一mask数组，且z应源自原始z_grid（而非z变量本身），避免因z数组维度错位引发渲染异常； -
避免透明度方案：虽可用
opacity分段绘制，但需双倍网格与图层叠加，显著增加内存与渲染开销，而本方案零额外计算成本； -
进阶提示：若需多段保留（如 0°–25° 和 180°–205°），可构造复合布尔掩码
mask = ~((theta_grid >= 0) & (theta_grid 。
通过此方法，您将获得几何精确、边缘锐利、无畸变的局部圆柱面可视化，适用于工程管道分析、传感器覆盖模拟等对空间保真度要求严格的场景。
