
本文详解如何使用 Matplotlib 动画功能,结合结构化网格重映射与 pcolormesh 动态更新机制,构建一个随时间演化的水体动画——热力图严格贴合瞬时水面高度,消除空白区域,真实反映流场与自由表面耦合关系。
本文详解如何使用 matplotlib 动画功能,结合结构化网格重映射与 `pcolormesh` 动态更新机制,构建一个随时间演化的水体动画——热力图严格贴合瞬时水面高度,消除空白区域,真实反映流场与自由表面耦合关系。
在模拟水体动力学(如浅水方程、层析流或实验室水槽仿真)时,常需将水平速度场(U)与自由表面高程(H)联合可视化。核心挑战在于:热力图不能固定在统一的 y 坐标网格上,而必须随每个 x 位置处的瞬时水深动态拉伸/压缩。原代码中 pcolormesh 使用静态 y_base = linspace(0, 1, ny) 导致所有时刻都绘制在 [0,1] 区域内,而实际水面高度 H[t, i] 可能远小于或大于 1 —— 这正是“区域上方为空白”的根本原因:pcolormesh 仅对定义的四边形网格单元着色,超出 Y_dynamic 范围的像素不会自动填充,且 set_offsets 并不能改变网格拓扑结构。
✅ 正确解法是:为每一帧重建完整、非均匀的四边形网格(quadmesh),而非尝试复用 set_offsets(该方法适用于平移/缩放,不适用于形变)。推荐使用 ax.pcolormesh(X, Y, U, ...) 每帧重新绘制,其中 Y 是形状为 (ny+1, nx+1) 的二维网格(含边界),通过插值确保每个列(x_i)对应独立的垂直剖面 [0, H[t,i]]。
以下为优化后的完整实现:
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
import numpy as np
import matplotlib.pyplot as plt
import matplotlib.animation as animation
# 示例数据生成(替换为你的真实 hraw/uraw)
timesteps, nx, ny = 174, 200, 50
hraw = np.random.rand(timesteps, nx, ny) * 0.8 + 0.3 # 水面高度 ∈ [0.3, 1.1]
uraw = np.random.randn(timesteps, nx, ny) * 0.2 # 速度场,含正负
x = np.linspace(0, 1, nx)
X = np.tile(x, (ny + 1, 1)) # shape: (ny+1, nx)
fig, ax = plt.subplots(figsize=(10, 6))
ax.set_xlim(0, 1)
ax.set_ylim(0, 1.2)
ax.set_xlabel('x')
ax.set_ylabel('Height')
ax.set_title('Water Animation: Surface + Velocity Heatmap')
colorbar = None
def init():
global colorbar
# 初始帧:构建首个动态网格
H0 = hraw[0, :, -1] # 取每列顶部高度(即自由表面)
Y0 = np.array([np.linspace(0, H0[i], ny + 1) for i in range(nx)]).T # (ny+1, nx)
U0 = uraw[0].T # (ny, nx) → 需匹配 pcolormesh 的 (ny, nx) 输入(非转置!)
mesh = ax.pcolormesh(X, Y0, U0,
shading='flat', # 关键:匹配 (ny+1, nx+1) 网格边界
cmap='seismic',
vmin=-0.3, vmax=0.3)
surface_line, = ax.plot(x, H0, 'w-', lw=2, label='Free Surface')
colorbar = fig.colorbar(mesh, ax=ax, label='Horizontal Velocity u')
ax.legend()
return mesh, surface_line
def update(t):
H = hraw[t, :, -1]
# 构建当前帧的 (ny+1, nx) 动态 Y 网格:每列从 0 到 H[i]
Y = np.array([np.linspace(0, H[i], ny + 1) for i in range(nx)]).T
# 重绘热力图(关键:每次新建 mesh,保证几何一致性)
ax.collections.clear() # 清除旧热力图
mesh = ax.pcolormesh(X, Y, uraw[t].T,
shading='flat',
cmap='seismic',
vmin=-0.3, vmax=0.3)
# 更新水面线
surface_line.set_ydata(H)
ax.set_title(f'Timestep {t}')
return mesh, surface_line
ani = animation.FuncAnimation(
fig, update, frames=timesteps,
init_func=init, interval=100, blit=False, repeat=True
)
plt.tight_layout()
plt.show()
? 关键要点与注意事项:
-
shading='flat'是必须的:它要求输入U为(ny, nx),对应(ny+1, nx+1)的网格顶点,从而精确控制每个四边形单元的高度范围。 -
不要复用
set_array()+set_offsets():pcolormesh的set_offsets仅平移已有单元,无法改变其垂直尺度;形变必须通过重建Y网格实现。 -
Y必须是二维数组(ny+1, nx):每一列Y[:, i]是第i个 x 位置上从床底(0)到水面H[i]的等距分层坐标。 -
性能提示:若
timesteps极大(>1000),可考虑用FuncAnimation(... blit=True)+ 手动缓存ax.images,但需额外管理 artist 生命周期;对于常规仿真(~200 帧),blit=False更稳健。 -
数据加载建议:确保
hraw[t, i, -1]确实代表第t时刻第i个 x 位置的自由表面高程(即垂直方向最后一层);若你的数据存储顺序不同,请先np.swapaxes()对齐维度。
最终效果:热力图将严格“贴合”起伏的水面轮廓,无任何空白或错位,速度符号(红/蓝)直观反映流向,真正实现物理一致的流-面耦合可视化。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










