《SoftwareX》:xslope: An open, validated Python package and desktop application for integrated seepage and slope stability analysis
编辑推荐:
定量边坡稳定性评估依赖三种分析模式:用于稳定性分析的极限平衡法(LEM)和有限元强度折减法(SSRM),以及用于孔隙水压力计算的地下水渗流分析。这些分析通常在昂贵且封闭的商业软件套件中运行,而现有的开源工具一次只能覆盖其中一种模式。xslope是一个开源软件包
定量边坡稳定性评估依赖三种分析模式:用于稳定性分析的极限平衡法(LEM)和有限元强度折减法(SSRM),以及用于孔隙水压力计算的地下水渗流分析。这些分析通常在昂贵且封闭的商业软件套件中运行,而现有的开源工具一次只能覆盖其中一种模式。xslope是一个开源软件包,它从单一共享问题定义出发集成了全部三种模式:七种LEM方法、有限元SSRM,以及用于饱和与非饱和流动、稳态或瞬态分析的有限元渗流。研究人员针对两个广泛使用的商业软件套件(Rocscience Slide2和RS2、GeoStudio SLOPE/W和SEEP/W)的已发布验证手册以及经典解析基准进行了验证,复现了超过230个基准问题及其所包含的近700个独立数值,所有内容均作为自动化回归测试套件随软件发布。xslope可读写GeoStudio(SLOPE/W)文件并导入Rocscience(Slide2、RS2)输入文件,因此能够融入现有工作流程。该软件既可作为可脚本化库发布,也可作为跨平台桌面应用程序XSLOPE Studio发布,其可脚本化核心将求解器开放给封闭软件所不允许的参数化、蒙特卡洛可靠性和AI辅助工作流。xslope以Apache 2.0许可证发布,附带完整文档和可复现的验证文件。
一、研究背景与意义
边坡稳定性分析是岩土工程实践中的核心内容,定量评估通常依赖三种互补的分析模式:两种用于破坏分析,即基于条分法的极限平衡法(LEM)和基于有限元的强度折减法(SSRM);一种用于地下水渗流分析,以表征两种破坏分析所需的孔隙水压力场。LEM方法将破坏体划分为垂直条块,是计算安全系数(FOS)的常规选择,从忽略条间力的简单方法到满足完整静力平衡的严格公式不一而足。SSRM以有限元实现,无需假定破坏面的形状或位置即可定位临界破坏面。在孔隙水压力起关键作用的场景中,如土坝、基坑和快速降水位情况,可靠的分析首先需要渗流解来表征两种破坏方法所需的孔隙水压力场。
在实践中,这些分析在商业软件套件中完成,通过共享几何、材料和其他输入集成渗流与稳定性分析。这些软件包是专有的且成本高昂:结果背后的实现无法被检查、审计或扩展,许可费用使完整工具集超出了许多从业者的承受范围,尤其是小型企业、学术机构和欠发达地区的用户。封闭的图形程序也难以编程驱动,限制了现代计算地球科学所依赖的参数化、优化和可靠性工作流。现有开源工具仅解决部分问题:LEM分析可用的轻量级Python工具如pyslope和pyBIMstab;有限元强度折减主要存在于研究代码中;变饱和渗流则有USGS SUTRA和OpenGeoSys等成熟代码,但均未与稳定性引擎集成。据研究人员所知,从单一模型定义集成全部三种模式此前仅存在于GeoStudio等封闭商业套件中。
xslope填补了这一空白。它是一个开源Python包,将一个问题定义贯穿有限元渗流、LEM和有限元SSRM,无需手动传递或重新划分网格。其意义体现在四个方面:大规模验证(复现超过230个已发布基准问题,提供近700个独立检查值,以自动化回归套件随包发布);可编程与图形界面(既提供可脚本化Python库,也提供跨平台桌面应用XSLOPE Studio);开放可脚本化(每个算法均可检查与扩展,API暴露验证过的求解方法);互操作性(读写GeoStudio SLOPE/W项目文件,导入Rocscience Slide2和RS2模型)。
二、研究内容与主要技术方法
研究人员开发了xslope软件包,采用纯Python实现,仅依赖开放科学栈(NumPy、SciPy、pandas和Matplotlib),有限元模式需要Gmsh网格生成器自动从几何构建网格。所有三种模式使用单一Excel输入模板定义几何、材料属性、边界条件和分析控制。主要关键技术方法包括:有限元渗流模块求解二维有限元网格上的稳态地下水流方程,支持各向异性材料、承压与非承压问题、三种非饱和相对渗透率模型(线性前沿函数、van Genuchten模型、Gardner幂形式)以及瞬态求解(θ方法、Picard迭代和自适应步长控制);LEM模块提供七种方法(普通条分法、Bishop简化法、简化Janbu法、美国陆军工程师团法、Lowe和Karafiath法、Spencer法、Morgenstern-Price法),支持圆形和非圆形临界滑面搜索、快速降水位多阶段分析、柔性加筋和抗滑桩;SSRM模块采用弹塑性有限元公式,使用Griffiths和Lane的粘塑性算法,支持Mohr-Coulomb、随深度变化的不排水强度、幂曲线和广义Hoek-Brown强度包络线;验证采用两层基准套件:解析锚点(闭合形式解)和已建立代码的交叉检验,逐问题对照Rocscience(Slide2和RS2)与GeoStudio(SLOPE/W和SEEP/W)的已发布验证手册。验证语料库包括Rocscience Slide2验证手册111个问题(LEM)、RS2验证手册120个问题(SSRM)、Slide2地下水验证手册21个问题(渗流)、SLOPE/W验证手册47个问题(LEM)、SEEP/W示例库7个问题(瞬态渗流)以及解析锚点,共235个问题在自动化回归套件中复现,提供691个独立检查值。
三、主要研究结果
耦合渗流与稳定性分析。 以Johnson Reservoir土石坝问题为例,该坝具有透水壳层(k=0.30 m/day)、低渗透心墙(k=3×10-4 m/day)和基础层(k=0.030 m/day)。单一Excel输入文件定义所有三种模式的几何和材料。稳态渗流分析在二次三角形网格上绘制出跨心墙急剧下降的浸润面,总流量为0.180 m3/day每单位长度。网格和孔隙水压力场随后传递给两种稳定性分析:Spencer法在临界圆弧面上计算安全系数为1.25,SSRM在相同网格上计算安全系数为1.23,剪应变从坝顶下方朝下游趾部集中。两种方法结果接近且定位相同破坏机制。在Apple M1 Max硬件上,1605单元网格(3362节点)的渗流求解运行0.3秒,Spencer搜索838个试验圆运行6秒,SSRM运行50秒。
AI辅助问题设置与实现。 演示了两种能力。第一种是生成输入文件:分析人员附上横截面图像、手绘图照片、报告截图或CAD导出,智能体提取几何、材料属性、边界条件、水位和荷载,编写完整输入文件并运行分析。该技能为纯文本格式,可跨助手移植,测试中同一图像和提示在多个独立助手中产生相同输入文件和安全系数,包括Claude(Anthropic)和GLM(Z.ai)。第二种能力是编排:给定自然语言提示如"在20到30度坡角范围内运行可靠性分析并标记仍满足0.75设计可靠性的最陡角度",智能体在请求的几何范围内循环,在每个角度调用内置可靠性分析并绘图。以ACADS均质边坡为基准案例,曲线在β≈22.8°处穿越0.75设计目标,该过程驱动Bishop求解器约100,000次,在笔记本电脑上约四分钟完成。
验证结果。 在解析锚点方面,xslope复现承压径向流闭合形式流量优于0.01%,匹配Pavlovsky保角映射解(部分贯穿截水墙)在0.3%以内,跟随Terzaghi一维固结级数在初始超孔隙水压力的0.2%以内,Ferris承压含水层误差函数解在0.006 m以内。对已建立代码语料库,超过90%的问题在发布值的3%以内一致,其余问题均被单独说明原因,如强度场仅以等值线图发布、安全系数在细化下不趋于网格无关、或两代码间的本构差异。
四、讨论与结论
xslope改变了无法或不愿在封闭商业套件中工作的用户的可能范围。通过复现商业软件自身发布的验证语料库和教科书案例,提供了与所补充的商业套件相当、且可供用户逐值检查的证据基础,内置回归套件随代码变化保持最新。由于可读写GeoStudio文件并导入Rocscience模型,它可以作为第二意见、脚本引擎或教学工具进入现有项目,而无需强制切换主要软件。原生Python访问求解器将参数化研究、蒙特卡洛可靠性、优化设计和AI辅助设置转变为普通脚本,分析可以精确存档、共享和重运行,促进同行评审、监管文档和可复现研究。开放许可和图形前端或可脚本化库的选择消除了成本障碍和代码障碍,拓宽了能够进行可靠三模式边坡分析的人群,同时保持底层算法开放供检查和扩展。
研究结论:xslope在单一开源框架中集成了三种分析模式——LEM和有限元SSRM边坡稳定性分析,以及稳态和瞬态有限元渗流分析——由单一共享问题定义驱动。它既可作为可脚本化Python库也可作为桌面应用使用。其验证规模在开源岩土软件中不同寻常,复现了来自Rocscience Slide2和RS2以及GeoStudio SLOPE/W和SEEP/W验证手册的超过230个已发布基准问题及其中近700个独立检查值,并辅以经典解析基准。它通过GeoStudio和Rocscience导入导出与商业工具互操作,结果以标准格式导出用于报告和出版物。其开放、可脚本化架构将验证过的求解器暴露给参数化、可靠性和AI辅助工作流,降低了该工具集在教学和资源不足实践中的成本、透明度和访问障碍。未来工作可包括三维分析、动力地震分析、应变软化本构模型、完全耦合的水力-力学公式以及更复杂的土-结构相互作用模型。