Plant 3D中Python自定义T型管支座参数更新异常问题

安全阿岳

2026-6-12

Plant 3D Python自定义T型管支座参数更新异常排查

我在Plant 3D中用Python开发了一款带双侧L型支架的倒置T型管支座（T-Shoe），初始几何形态完全正常。但通过Spec Editor编辑属性、更新参数S（T型支座与L型支架的间距）时，模型形态出现损坏：L型支架形状变形，且T型支座整体下沉到底部。我设计的参数S仅用于控制L型支架的水平滑动，并未关联任何形状参数，目前无法定位异常原因，相关实现代码如下：

from aqa.math import *
from varmain.primitiv import *
from varmain.var_basic import *
from varmain.custom import *

# =============================================================================
# MCA - 倒置T型管支座，带对称双侧L型支架
# =============================================================================
#
# 参数行为说明（独立无交叉影响）：
#   D    : 预留参数（管道直径）-- 不移动/缩放任何部件
#   L, W : 法兰板尺寸
#   H, T : 支座总高度 / 钢板厚度（竖杆高度 = H - T）
#   S    : 仅控制双侧L型支架的水平滑动，支架中心位置 = +/- (50+S)，
#          默认S=25时位置为+/-75（该位置已验证正常）。
#   L型支架尺寸为固定硬编码值（已验证形状正常，不做参数化）。
#
# 所有形状直接放置在最终显示位置：无X轴旋转翻转，无偏移修正。支座锚定在BASE_Z（竖杆底部），
# 该位置不随任何参数变化，因此部件不会"下沉"。默认参数值可完全复现已验证的正常渲染效果。

@activate(Group="Support", TooltipShort="管支座",
          TooltipLong="带双侧对称L型支架的倒置T型管支座",
          LengthUnit="mm", Ports="1")
@group("MainDimensions")
@param(D = LENGTH, TooltipShort="管道直径")
@param(L = LENGTH, TooltipShort="支座长度")
@param(W = LENGTH, TooltipShort="法兰宽度")
@param(H = LENGTH, TooltipShort="支座总高度")
@param(T = LENGTH, TooltipShort="钢板厚度")
@group("SideGuides")
@param(S = LENGTH0, TooltipShort="法兰边缘到L型支架的间距")

def mca(s, D=80.0, L=150.0, W=100.0, H=100.0, T=12.0,
        S=25.0, ID="MCA", **kw):

    # 属性编辑可能传入字符串类型参数，统一转换为浮点型避免运算错误
    D = float(D)
    L = float(L)
    W = float(W)
    H = float(H)
    T = float(T)
    S = float(S)

    # -------------------------------------------------------------------------
    # T型支座 -- 直接放置在最终位置，锚定在BASE_Z。
    # 默认参数对应正常渲染效果：
    #   竖杆范围z -25..63，法兰覆盖z 63..75
    # 修改H/T时从固定底座向上延伸，不会移动支座位置。
    # -------------------------------------------------------------------------
    BASE_Z = -25.0          # 竖杆底部：固定锚点，与参数无关
    stem_h = H - T

    body = BOX(s, L=L, W=W, H=T).translate(
        (0.0, 0.0, BASE_Z + stem_h + T / 2.0))   # 法兰盖在竖杆顶部

    stem = BOX(s, L=L, W=T, H=stem_h).translate(
        (0.0, 0.0, BASE_Z + stem_h / 2.0))
    body.uniteWith(stem)
    stem.erase()

    # -------------------------------------------------------------------------
    # L型支架 -- 尺寸为固定硬编码值（已验证形状正常，不做参数化）。
    # S仅控制其沿X轴滑动，中心位置 = +/- (50 + S)。
    # 默认S=25时中心位置为+/-75，与之前验证的正常位置一致。
    # -------------------------------------------------------------------------
    guide_x = 50.0 + S

    # 右侧支架
    foot_r = BOX(s, L=40.0, W=12.0, H=60.0).translate((0.0, 20.0, 6.0))
    web_r  = BOX(s, L=12.0, W=40.0, H=60.0).translate((0.0, -5.0, 20.0))
    foot_r.uniteWith(web_r)
    web_r.erase()
    foot_r.rotateZ(90.0)
    foot_r.translate((-guide_x, 0.0, 0.0))

    # 左侧支架 -- 右侧支架的镜像，使用相同硬编码尺寸
    foot_l = BOX(s, L=40.0, W=12.0, H=60.0).translate((0.0, -20.0, 6.0))
    web_l  = BOX(s, L=12.0, W=40.0, H=60.0).translate((0.0, 5.0, 20.0))
    foot_l.uniteWith(web_l)
    web_l.erase()
    foot_l.rotateZ(90.0)
    foot_l.translate((guide_x, 0.0, 0.0))

    # -------------------------------------------------------------------------
    # 连接端口 （未修改）
    # -------------------------------------------------------------------------
    s.setPoint((0.0, 0.0, L + 30), (0.0, 1.0, 0.0))

异常原因分析

T型支座下沉问题：
代码中BASE_Z固定为-25.0，但连接端口setPoint的Z坐标使用了参数L（(0.0, 0.0, L + 30)），而L是T型支座的长度参数。当通过Spec Editor修改参数时，Plant 3D会基于端口位置重新定位整个部件，导致原本锚定在BASE_Z的支座被强制移动到端口所在的Z轴位置，引发下沉。
L型支架形状变形问题：
L型支架的创建顺序是先平移、再旋转、最后再次平移，但Plant 3D的几何变换是基于局部坐标系累积的。旋转操作会改变部件的局部坐标轴方向，后续的平移(-guide_x, 0.0, 0.0)会基于旋转后的坐标系执行，导致实际移动方向偏离预期，进而拉伸/扭曲支架形状。

修复方案

1. 修正连接端口的Z坐标，确保部件锚点稳定

将端口的Z坐标改为基于固定锚点BASE_Z的计算值，避免参数L影响部件整体位置：

# 原代码
s.setPoint((0.0, 0.0, L + 30), (0.0, 1.0, 0.0))
# 修改为
s.setPoint((0.0, 0.0, BASE_Z + H + 30), (0.0, 1.0, 0.0))

2. 调整L型支架的变换顺序，避免旋转后坐标系偏移

先执行旋转操作，再进行平移和组合，确保所有变换基于全局坐标系：

# 右侧L型支架修正
foot_r = BOX(s, L=40.0, W=12.0, H=60.0)
web_r = BOX(s, L=12.0, W=40.0, H=60.0)
# 先旋转，再平移到目标位置后合并
foot_r.rotateZ(90.0)
foot_r.translate((-guide_x, 20.0, 6.0))
web_r.rotateZ(90.0)
web_r.translate((-guide_x, -5.0, 20.0))
foot_r.uniteWith(web_r)
web_r.erase()

# 左侧L型支架修正
foot_l = BOX(s, L=40.0, W=12.0, H=60.0)
web_l = BOX(s, L=12.0, W=40.0, H=60.0)
foot_l.rotateZ(90.0)
foot_l.translate((guide_x, -20.0, 6.0))
web_l.rotateZ(90.0)
web_l.translate((guide_x, 5.0, 20.0))
foot_l.uniteWith(web_l)
web_l.erase()

3. 额外验证：参数类型与输入处理

确认S参数的类型LENGTH0是否符合Plant 3D的参数规范，若存在类型不匹配，可改为LENGTH并在代码中处理0值情况：

@param(S = LENGTH, TooltipShort="法兰边缘到L型支架的间距")

内容的提问来源于stack exchange，提问作者Krithik Tamilselvan