使用Python的Open3D可视化torus时凸起不显示的问题排查

一、修复Torus凸起不可见问题 #

凸起看不到的核心原因是顶点扭曲幅度不足或凸起逻辑未精准作用于目标区域，以下是保证顶点/面数完全一致的单凸起实现：

核心实现代码 #

import numpy as np
import open3d as o3d

def create_torus_with_bulge(radius=2, tube_radius=0.5, theta_res=64, phi_res=32, 
                           bulge_angle_range=(np.pi/4, 3*np.pi/4), bulge_height=0.3):
    # 生成标准Torus顶点坐标
    theta = np.linspace(0, 2*np.pi, theta_res)
    phi = np.linspace(0, 2*np.pi, phi_res)
    theta, phi = np.meshgrid(theta, phi)
    
    # 基础Torus坐标计算
    radial_base = radius + tube_radius * np.cos(phi)
    x = radial_base * np.cos(theta)
    y = radial_base * np.sin(theta)
    z = tube_radius * np.sin(phi)
    
    # 仅在指定角度范围内生成凸起
    mask = (theta >= bulge_angle_range[0]) & (theta <= bulge_angle_range[1])
    # 让凸起随phi平滑过渡，避免尖锐断层
    radial_base[mask] += bulge_height * np.cos(phi[mask])
    
    # 更新顶点坐标
    x = radial_base * np.cos(theta)
    y = radial_base * np.sin(theta)
    
    # 沿用标准Torus的面生成逻辑，保证面数一致
    faces = []
    for i in range(phi_res-1):
        for j in range(theta_res-1):
            v1 = i * theta_res + j
            v2 = i * theta_res + (j+1)
            v3 = (i+1) * theta_res + (j+1)
            v4 = (i+1) * theta_res + j
            faces.append([v1, v2, v3])
            faces.append([v1, v3, v4])
    
    # 构建Open3D网格
    mesh = o3d.geometry.TriangleMesh()
    mesh.vertices = o3d.utility.Vector3dVector(np.column_stack((x.flatten(), y.flatten(), z.flatten())))
    mesh.triangles = o3d.utility.Vector3iVector(faces)
    mesh.compute_vertex_normals()
    return mesh

# 测试可视化
mesh = create_torus_with_bulge(bulge_height=0.4)
o3d.visualization.draw_geometries([mesh])

关键注意点 #

• 用mask精准锁定凸起的角度范围，仅修改目标区域顶点，其余顶点保持原样
• 凸起高度关联np.cos(phi)，确保凸起在Torus管的圆周方向平滑过渡
• 面生成逻辑完全复用标准Torus结构，保证顶点数、面数与原始模型完全一致

二、修复Meshplot交互式预览失效问题 #

针对meshplot交互功能异常，可尝试以下方案：

• 强制切换到离线渲染后端：

import meshplot as mp
mp.offline()  # 启用plotly离线后端
p = mp.plot(np.asarray(mesh.vertices), np.asarray(mesh.triangles))
p.show()

• 对齐依赖版本：meshplot的交互功能对版本兼容性要求高，建议安装指定版本：

pip install meshplot==0.4.0 plotly==5.15.0 numpy==1.24.3

• 优先在Jupyter环境使用：meshplot的交互式功能在Jupyter Notebook/Lab中兼容性最佳，本地脚本建议改用Open3D的原生交互式窗口（支持旋转、缩放查看细节）

三、效果验证小技巧 #

• 先设置较大的bulge_height（比如1.0），确认凸起可见后再逐步调整到目标尺寸
• 用mesh.paint_uniform_color([1,0,0])给网格上色，更易观察凸起形态
• 通过print(len(mesh.vertices), len(mesh.triangles))验证顶点数、面数是否符合要求

内容的提问来源于stack exchange，提问作者Jakaria Rabbi