FLAC3D桩梁单元内力云图绘制与多工况包络线提取方法

1. 为什么桩身内力不能像土体应力那样“随手”就出云图

先说个场景。我拿到一个已经算完的基坑桩锚支护模型，土体位移云图、基坑周边地表沉降都能直接切剖面导图，唯独到了桩单元和梁单元这里卡住了：想看一下支护桩沿深度的弯矩分布、锚索轴力分布，屏幕上没有直接能用的云图，只有结构单元本身被画成一根根“棍子”，颜色几乎不带内力信息。遇到这种情况，大多数人的第一反应是翻后处理菜单，看看“Color By”里面能不能选一个叫Bending Moment之类的属性。有，但真用起来会发现一堆限制，尤其是多个工况、多根桩要统一出图时，软件内置的那套东西远远不够用。

本文就记录一下我这个阶段的完整探索过程。主题非常聚焦：在FLAC3D中，如何把桩单元（pile）与梁单元（beam）的弯矩、轴力和剪力，做成可读、可校验、能用于工程判断的内力云图，以及做多工况包络线显示。文章适合正在做基坑支护、边坡抗滑桩、桩基水平承载分析的朋友参考，也适合被FLAC3D结构单元后处理“劝退”过、想换个思路的人看。

先把结论放在前面：FLAC3D不是不能显示结构单元内力，而是它的默认后处理偏向“连续介质结果”，对pile、beam这类结构单元，内置的可视化能力很有限，大量用户抱怨的根因在这里。我们自己动手把内力数据取出来，再映射到单元几何上，是更稳定、更可控的一条路。

1.1 默认后处理里能看到的和不能看到的

FLAC3D 的 Plot 面板里，选中一个 pile 对象，常规可以显示的是几何形状、节点位移、速度、以及一部分单元属性，比如截面尺寸、材料ID、耦合弹簧刚度。如果做一些比较细的设置，也可以按单元属性上色，但这个“属性”更多是模型的输入参数，而不是求解后的内力结果。真正求解得到的轴力、剪力、弯矩，在软件的默认交互面板里通常没有一个像contour of zone stress那样漂亮的连续云图。

这跟FLAC3D的架构有关。FLAC3D的主体求解器对连续介质区域（zone）是有完整应力应变张量的，单元积分点上的值天然可以插值成云图；而结构单元是为了模拟梁、桩、锚杆等特意加进来的“低维构件”，它们的力学量是在局部坐标系下计算的，各自独立的单元段也是一段一段的，想直接做全模型范围的云图，软件内部并没有做很深入的统一映射。

所以我在探索初期就明确了一个观点：如果想要得到“像ABAQUS/PLAXIS那种沿桩身连续渐变的内力色带”，那大概率不能指望FLAC3D一个按钮全部搞定，必须走“数据导出+自行可视化”的路线。后面的内容基本就是围绕这个路线展开的。

1.2 结构内力在FLAC3D中是“中间量”而不是“结果张量”

这里需要多说一句，因为不少人栽在概念混淆上。

土体单元的应力是材料本构关系直接给出的，是一种“结果张量”——积分点上的应力状态是由应变增量按本构更新得到的。桩单元或梁单元则不同，它本质上是梁柱单元，轴力、剪力、弯矩是根据节点位移和单元刚度矩阵推出来的截面内力，属于“中间量”或者叫“派生量”。这意味着你从单元里看到的输出并不是某个可以直接云图化的高维张量，而是一组定义在局部坐标系下的截面力。

这个区别直接决定了后面的处理方式。

既然是截面内力，那么想要漂亮云图，就得先解决三个问题：第一，怎么按单元段批量取出N、V、M；第二，这些值是基于哪个局部坐标系算的，方向怎么统一；第三，把值附着到几何线段的哪个位置、按什么方式着色才能读出工程含义。下面几节就从这三个问题逐个展开。

2. 弯矩、剪力、轴力藏在哪儿：读取前的三个概念问题

在动手写任何脚本之前，先把概念理清楚能省很多返工时间。我第一次做的时候就因为搞混了pile 与 beam 的力学差异，差点把一组完全不对的数据当成结果导出来。

2.1 pile 与 beam 在力学模拟上的本质区别

FLAC3D 里常用的结构单元有好几类，其中桩单元（pile）和梁单元（beam）在几何外观上很容易混淆，都是空间中的线单元，也都具有梁弯曲刚度。但在实际模拟中，两者的角色差异非常大。

• beam 单元通常用于模拟“结构构件”，比如钢支撑、格构柱、联系梁。它与周围岩土体的连接比较“直接”，节点可以通过 link 与 zone 节点刚接或铰接，不专门考虑接触面上的法向、切向刚度退化。
• pile 单元则更强调“桩土接触”，它有专门的耦合弹簧（coupling spring），用于模拟桩侧摩阻和端承力。所以当你关心的对象是穿过土体、靠桩土相互作用承载的灌注桩或管桩时，应该优先使用 pile。

这个差异看着简单，实际在输出内力时非常关键。因为 pile 单元的节点内力不只是杆件内部变形产生的，还包含了耦合弹簧沿桩身传递的土反力。换句话说，同一个位置的截面轴力，既受上部荷载影响，也受桩侧摩阻力的分布路径影响。你从每个段上取到的内力，天然就是“土-结构共同作用之后的结果”，所以不要奇怪为什么桩顶和桩端的轴力往往不一样，这正是需要看轴力云图的原因。

表1总结了常见的结构单元属性和它们适合输出的对象：

为什么后处理时 pile 没有出现“一键弯矩云图”？正是因为它不是单一的一个物理量能直接跨单元连续表达的。桩单元和土单元完全不一样：土体单元是同一个连续体里的微小区域，相邻区域间量是连续变化的；而每个 pile 单元段有自己独立的局部坐标系和端部内力，所以要画成云图，必须先把它处理成一种“可插值的标量场”。

2.2 局部坐标系与截面内力的方向约定——云图能不能读懂的命门

这一节我想重点展开，因为它是我踩坑最多的地方。

很多人在PPT、论文里看到一张很漂亮的桩身弯矩云图，红绿蓝渐变，以为只要取一个弯矩值着色就行。真正动手后才发现，FLAC3D 里每个结构单元在空间都有自己的朝向，轴力的方向是沿着单元轴向的，剪力的方向在横截面的两个方向上，弯矩方向也有对应的局部坐标轴。如果局部坐标系没有搞清楚，那导出来的M值可能是Mx、My、Mz中的某一个，而不是空间桩身弯曲对应的那个方向。

拿一根竖直抗滑桩来举例。如果桩轴方向基本沿世界坐标系的Z轴，那么桩身水平方向的剪力对应的是Fx或Fy，绕水平轴的弯矩可能对应My或Mx。如果桩在空间是斜向的，比如山坡上的斜桩或者倾斜支撑，那局部坐标轴与全局坐标轴就不再对齐。此时如果不处理坐标方向，直接把“本单元局部M”丢进去画图，相邻单元之间就会出现颜色突变，因为相邻单元的局部坐标方向可能本来就不同。

所以在取数阶段，我要多做一步：将局部坐标系下的内力量投影或者区分成我们需要的物理分量，再结合节点坐标判断符号方向，确保相邻单元结果的可比性。这里不是要你手动做张量旋转，但至少要明确“我画的是哪个方向上的弯矩”“哪个方向是受压侧”这两个问题。

还有符号约定。在FLAC3D的结构单元中，具体哪个方向算正、哪个算负，不同版本和单元类型不完全一致。比如轴力，有的约定拉力为正、压力为负，也有输出恰好相反的后处理变量。弯矩的符号同样会因为局部坐标轴的选取而整体翻转。别小看这个问题，画单根桩的沿深度分布曲线还没有特别明显，一旦画成三维云图，符号错了就是受拉受压完全反过来，工程判断跟着就错。后面第5节我会专门讲怎么校验这种“看似做对了、实际全反了”的情况。

3. 自制云图：取数、排序、映射的一条完整路线

概念问题理清之后，就进入真正能落地的环节了。我的建议路线是三步：取数、组织、着色。核心原则是“把每一个桩/梁单元段看作一条带内力属性的线段，先把数据和几何导出来，再在外部工具里按属性着色”。

3.1 用FISH/内嵌Python把所有结构单元内力导出为外部数据

FLAC3D 的建模和分析能力很强大，结构单元数量一般也不会少。在正式的支护桩模型里，动辄几十根桩、每个桩沿深度再细分成十几段，合计可能有几百个单元段。想靠人眼一个个读肯定不现实，必须通过FISH脚本或FLAC3D内嵌Python批量遍历结构单元，取出单元两端点的坐标、单元所属ID、以及截面轴力、剪力、弯矩。

在FLAC3D 6.0及以后的版本里，遍历结构单元已经可以基于列表遍历方式实现。以FISH的典型写法为例，思路大致是这样：

fish复制; 示意代码——不同小版本关键字略有差异，运行前请对照版本函数表核对
def export_pile_forces
  local p_pile = pile.head
  loop while p_pile != null
    local id = p_pile.id
    ; 获取单元两个端点坐标
    ; 获取单元的截面信息：面积、惯性矩、长度等
    ; 获取单元的轴向力、剪力、弯矩
    ; 将这些数据追加到数组或直接写入指定文件
    p_pile = p_pile.next
  endloop
end

不熟悉FISH也没有关系。FLAC3D新版本里支持Python环境，可以直接用Python遍历结构单元对象，并将结果用pandas或CSV模块写出来。Python路径的好处是组织数据方便，但需要注意，取结构单元内力具体函数的写法在不同版本之间差异比较大，不能指望完全不变。我的建议是先打开帮助文档，检索结构单元（Structure Element）里关于“内部作用力（internal force）”或“节点反力”的部分，找到当前版本实际可用的函数名再套进遍历脚本。

导出文件的格式要有讲究。一段最简单的CSV可以这样组织：

text复制pile_id,seg_id,x1,y1,z1,x2,y2,z2,N,Vy,Vz,Mx,My,Mz

这个文件里看起来字段很多，但实际在后面配色和绘图时非常有用。因为每一条线段有两个端点坐标，我们就可以知道单元段的几何位置；而对应的N、V、M就是着色用的数据。

这里有一个注意点：FLAC3D 结构单元上的内力输出位置，可能是单元中点，也可能是端部值。如果是单元中点，则这一行数据只能表示这一段范围的平均内力。想在云图里表现出“沿桩身渐变”，就要保证桩沿长度方向被划分得足够细，否则会看到一节一节的阶梯色块，而不是渐变条带。

3.2 把内力值“画”到单元线段上：外部可视化的处理思路

拿到CSV数据之后，第一种可行的做法是用Tecplot或ParaView打开。Tecplot里可以直接把点坐标和标量列读进去，然后用“line/section”方式显示切片云图；ParaView同样是读取CSV或者VTK格式后，用管线渲染成线段云图。

不过，我个人在实际操作中发现，如果只是看一根或几根桩的分布，用一个数据可视化脚本就够了。以Python和matplotlib为例，可以先把每一段桩按z坐标排序（对于竖直桩），再在桩的某个平面投影位置上画一列色块，或者直接把每个单元段的弯矩值作为颜色映射画那条线段。

下面是一个最小实现，画单根竖直桩的弯矩沿深度分布曲线：

python复制import pandas as pd
import matplotlib.pyplot as plt

# 读取从FLAC3D导出的数据
df = pd.read_csv("pile_forces.csv")

# 假设是竖直桩，深度用z坐标表示
depth = -df["z1"]  # 取单元起始点深度，负号根据坐标习惯调整
moment = df["My"]  # 选择你要查看的弯矩分量

# 按深度排序
df_sorted = df.sort_values("depth")
depth_sorted = -df_sorted["z1"]
moment_sorted = df_sorted["My"]

plt.figure(figsize=(5, 8))
plt.plot(moment_sorted, depth_sorted, marker="o")
plt.xlabel("Bending Moment (kN·m)")
plt.ylabel("Depth (m)")
plt.grid(True)
plt.show()

这段脚本虽然简单，但它揭示了一个本质：我们要做的，不是让FLAC3D“自动生成云图”，而是把FLAC3D算出的杆件内力，转成自己能控制的几何和物理量，再进行可视化。既然数据是CSV，那想画成什么表达形式都很自由。

上色方面，我建议使用离散色标而不是连续色标。工程出图时，分档显示更容易读出“哪一段弯矩超过设计值”。比如画桩弯矩云图时，把弯矩范围分为受拉控制段、受压控制段和过渡段。这样比给出一个彩虹色连续色带更符合工程交流习惯。

这一步里需要多花心思的是坐标排序。竖直桩好办，按z分量排序即可。斜桩或空间弯曲桩呢？我不建议直接按全局坐标系排序，最好沿桩方向计算弧长s。弧长的算法很简单：从桩顶开始，累积每一段的几何长度，也就是相邻坐标点的欧氏距离。

3.3 这个方案相比“在FLAC3D里调颜色”到底赢在哪

有人可能问：FLAC3D里真的不能直接做类似效果吗？我承认，某些较新版本的结构单元图例里确实有若干属性可以尝试上色，但用下来的核心痛点有三个——一是可选的属性不够全，不是所有内力分量都能稳定显示；二是显示范围很难控制，零星几个单元的异常值会把整个色标拉偏；三是不好叠加“包络”概念，软件本身并不会帮你自动追踪每个截面的最大/最小值。

而自己做数据导出后，相当于完全掌握了“绘图素材”。需要哪个物理量、取什么范围、怎么配色、要不要叠加多工况包络线，最终都只是对CSV做处理的问题。

4. 包络线显示：多工况下一根桩的最大值与设计取值

如果说云图解决的是“空间分布”问题，那包络线解决的就是“时间历程”问题。尤其在基坑分步开挖、边坡多阶段施工这类分析中，桩身最危险的截面往往不在最终的平衡状态，而在某一个中间工况。

4.1 不是取“最后一步云图”，而是全过程极值

我见过不少初学者用FLAC3D做完多步开挖后，直接看最后一步的桩身弯矩云图，然后根据它判定配筋够不够。这是个很危险的近似。开挖过程中，随着土体应力释放，桩身内力可能在某些中间工况达到峰值。最终状态的桩身弯矩分布只是“最后一个工况的结果”，并不是“整个过程中包络过的最大值”。

真实的包络线做法，是在每一个计算步（尤其是每个开挖工况）结束后，都去遍历一遍桩单元的所有截面，把这一截面历史上的最大轴力、最大弯矩记录下来。等所有工况全算完，沿桩身按深度整理出一组“最大值的包络线”和“最小值的包络线”。设计上看的往往是这组包络线，而不是某一帧云图。

在软件里怎么实现？思路很朴素。准备几个数组，数组长度等于桩的分段数。每算完一个工况，就把当前各单元段的内力读出来，如果比记录的最大值还大，就更新；如果比记录的最小值还小，也更新。最后所有工况算完，数组中保存的就是全程包络值。

伪代码大致是：

python复制# 每个工况结束后跑一次
for idx, seg in enumerate(pile_segments):
    N_now, M_now = read_segment_internal_forces(seg)
    N_max[idx] = max(N_max[idx], N_now)
    N_min[idx] = min(N_min[idx], N_now)
    M_max[idx] = max(M_max[idx], M_now)
    M_min[idx] = min(M_min[idx], M_now)

使用FISH时，可以用FLAC3D内置的数组变量把N_max、M_max这些存下来，在每个施工阶段solve完成后调用一次更新函数。注意数组长度要足够，索引要和桩段的遍历顺序保持一致，否则后面画出来就会乱。

4.2 用沿桩身坐标做包络：数据对齐和绘图技巧

做包络的关键难点是“对齐”——不同工况之间，同一根桩被划分的段可能没变，但如果你对桩周土做开挖、回填甚至大变形分析，桩段的编号和位置应该不变才对。只要模型里的桩结构单元没有在分析过程中重新划分，其实直接按CID或者按深度对齐是可行的。

更稳妥的方式是推荐统一采用“沿桩身弧长s”作为横坐标，而不是直接使用全局z坐标。因为如果是斜桩，z坐标相同的两个点并不代表同一截面位置，弧长才是真正沿轴向的物理位置。

表2是某水平受荷桩三个工况下桩身各深度处的弯矩记录示意：

看表就知道，如果我们只看最后工况3的结果，桩顶弯矩判断会偏小，而真正危险的是工况1时的桩顶，或者工况2时的1米深度处。只有逐截面求极值，才不会被某一个工况的分布“骗”过去。

画包络线也有一点小讲究。包络线并非只有一条，因为弯矩有正负，所以设计包络一般包含两条：正方向最大弯矩包络线和负方向最大弯矩包络线。绘制时我习惯用一根粗实线画Mmax，另一根粗虚线画Mmin，中间填充半透明色带。这样一张图上既能看出桩身全段的控制工况，也能看出弯矩正负交替的位置。

如果用matplotlib，可以这样写：

python复制import matplotlib.pyplot as plt

depth = [0.0, 1.0, 2.0, 3.0, 4.0]
Mmax = [120.3, 142.1, 156.3, 76.4, 30.1]
Mmin = [40.2, 56.3, 18.2, -18.6, -25.4]

plt.figure(figsize=(6, 8))
plt.plot(Mmax, depth, "r-", lw=2, label="Mmax")
plt.plot(Mmin, depth, "b--", lw=2, label="Mmin")
plt.fill_betweenx(depth, Mmin, Mmax, color="gray", alpha=0.2)
plt.xlabel("Bending moment (kN·m)")
plt.ylabel("Depth (m)")
plt.gca().invert_yaxis()
plt.legend()
plt.grid(True)
plt.show()

至于“包络线云图”，我个人的理解是，在多根桩并列时，可以用颜色渲染三维的桩身包络值。做法和前面云图的路线一致，只是把着色数据从“单一工况的内力”换成“所有工况中的包络值”。这类图优点是一眼能看出群桩中哪一根桩最危险。如果模型规模大，建议把桩按排或按区域分开出图，否则桩多时颜色会互相遮挡。

5. 验证与踩坑：颜色反转、局部轴翻转与附加变量索引

说实话，数据导出来、云图画出来并不算成功，只有经过校验之后，这个流程才算走完。这一节记录几个我实际遇到的坑，希望能帮你避开。

5.1 同一个单元弯矩符号为什么突然翻转

第一次做水平受荷桩云图时，我画出来的弯矩分布在桩顶和桩底之间颜色断掉了，看起来像是两段“性质完全相反”的材料。第一反应是数值算错了，回翻模型才发现问题不在求解器，而在局部坐标轴。

FLAC3D 对每个结构单元段的局部坐标轴方向，跟单元段的创建顺序有关。也就是说，同样一根桩，如果建模时是从桩底向上创建的，它的局部x轴方向和从桩顶向下创建的模型完全相反。局部轴反向之后，绕局部轴的弯矩符号就会整体反转。相邻的两段桩如果建模顺序不一致，出现数据符号反转就很正常。

这告诉我一件事：用云图前一定要先做“方向一致性”检查。检查方法不复杂，选一排受力模式明确的单桩，比如桩顶作用一个已知的水平力，初步判断在某个深度桩身弯矩应该是什么方向，再对比云图旋转后的方向对不对。如果方向不对，把该段的局部坐标方向统一一下就行，而不是怀疑FLAC3D内核算错了。

另一个更隐蔽的问题出现在颜色标尺的默认范围。FLAC3D或第三方绘图软件在画云图时，通常会按当前所有颜色的最大绝对值做对称标尺。如果桩端个别单元因为边界连接问题出现了很大的局部应力集中，那整根桩的颜色范围会被这个“离群点”拉得很宽，结果就是其他正常区段的云图颜色显示不出来，看起来像整根桩都没有内力。这时一定要手动截断标尺范围。我做项目时，通常会把所有单元内力值排序，去掉上下各5%的极值后再设定显示范围，这样图中的主体层次才清楚。

5.2 用桩顶反力或实体模型交叉校验导出的内力

数据能不能信，光看云图颜色是不够的。我常用的校验办法有两种。

第一种是平衡校验。单桩顶面如果有竖向荷载，桩身某一深度处的轴力应等于桩顶荷载减去该深度以上桩侧摩阻力之和；桩端轴力等于桩端土反力。如果导出的轴力分布和这个关系对不上，说明导出的物理量方向或符号约定有问题。这个方法不用额外建模型，纯靠手算抽查就能判断大方向。

第二种是“用实体单元模拟的桩做对比”。如果项目对桩身内力的分布非常敏感，我会建一个简化的实体桩模型（用连续介质单元模拟桩身），在同样的边界条件下受力，把实体桩的截面正应力积分成轴力与弯矩，再和pile单元结果做对比。两条曲线如果基本重合，那说明我们导出和可视化的流程是靠谱的。如果差别很大，就要回去检查pile的耦合参数和局部坐标系。用简化模型去校验真实模型的代表性物理量，是数值分析一个很值得长期坚持的习惯。

5.3 附加变量与单元ID的坑

有些用户在模型里会给桩周土体或结构单元附加额外变量（extra variable），用这些变量存内力。这个思路本身可行，但要特别小心单元ID和数组索引的错位。FLAC3D的zone id和结构单元id是两套体系，如果你把桩单元内力存到某个zone的extra变量里，后来新增或删除过单元，原来的索引可能全乱了。导出的数据里出现几条“飞线”——也就是离桩身老远的位置突然有一个高亮色块，多半就是单元ID读取错位了。

我自己比较推荐的做法是不要动extra变量，直接用独立的CSV保存数据和坐标，每次计算工况结束后全量导出。数据文件里带上坐标后，后续绘图校验都很方便。虽然文件会大一点，但数值分析的输出数据多留一份永远不是坏事。

6. 顺着这套思路能继续做的事：锚索、衬砌和群桩包络

把桩单元和梁单元的内力云图与包络线跑通之后，这个处理思路其实还能很自然地推广到其他结构单元。每批新项目开工前，我只需要把“遍历对象”和“输出物理量”换成对应的结构单元类型，整套代码骨架基本不用大改。

6.1 锚索轴力包络其实更简单

锚索（cable）单元往往只关心轴力，不涉及弯矩和剪力。做锚拉基坑时，锚索的自由段轴力沿长度变化很小，而锚固段因为与注浆体有剪切相互作用，轴力会逐渐衰减。对锚索做沿长度轴力云图，本质就是分段显示拉力的变化过程。多工况开挖时，某根锚索的内力可能先增后减，也可能因为下一道支撑施加而松驰。如果我们只看最终工况，就可能低估锚索峰值拉力。把每道工况后的锚索轴力做一次全模型遍历更新，最后画出来的“锚索轴力包络图”，会是验算锚索是否超张拉的一个非常有用的图。

6.2 衬砌和群桩的包络表达需要分层出图

liner单元和shell单元虽然是面单元，但它们的截面内力分布更丰富，比如膜轴力、弯矩、剪力。面单元云图可以直接用壳元结果的符号云图来画，不像线单元还要做线段映射。群桩包络则可以画成平面布置图上的“包络云图”：把每根桩的包络最大弯矩作为桩位的色块颜色，同时在每根桩旁边用一个小坐标系画出沿桩身的包络曲线。这种表达特别适合几十根桩一起评价的场景，给人的直觉冲击力比单根桩曲线强得多。

当然，面单元和群桩的包络对脚本要求更高，要考虑坐标插值、单元法向方向统一、以及不同分析阶段是否重分网格等问题，但所有这些都可以归到同一个核心流程里：先取数、再对齐、最后映射。你只要把这个流程打磨顺了，后面加多少工况、换什么单元，都能稳得住。

我在实际项目中还有一个体会：一次性把所有内力都导出来并保存到同一个数据文件，比每次只导当前要看的量更方便。因为多工况分析往往要反复切换对比，如果临时再回跑模型导数，光历史工况的重算耗时就很划不来。宁可前期多存一点原始数据，也别到后期“数到用时方恨少”。

探索云图显示的过程，本质上是在解决“视觉直觉”和“工程校验”的脱节问题。FLAC3D把桩、梁的力学行为算得很细，但默认后处理没有把最结论性的物理量摆到用户面前。既然软件没有给全现成的路，那就自己铺一条。把内力从单元里取出来、把包络值从工况里筛出来、再把它们画成能说服人的云图，走完这一趟，你对模型的理解会比任何一张软件自动导出的图都深。