《SoftwareX》:OpenDFN: an open-source kernel for generating conforming discrete-fracture-network meshes
编辑推荐:
离散裂隙网络(DFN)广泛用于表征裂隙岩体,但将不同的裂隙描述转换为保形计算网格仍是一项实际挑战。OpenDFN是一款开源预处理工具,用于从确定性节理、连续与非连续节理组、随机DFN以及由坐标导出的裂隙折线生成二维裂隙保形网格。这些裂隙描述可在统一的Gmsh/
离散裂隙网络(DFN)广泛用于表征裂隙岩体,但将不同的裂隙描述转换为保形计算网格仍是一项实际挑战。OpenDFN是一款开源预处理工具,用于从确定性节理、连续与非连续节理组、随机DFN以及由坐标导出的裂隙折线生成二维裂隙保形网格。这些裂隙描述可在统一的Gmsh/OpenCASCADE工作流中与基本域和开挖几何体相结合。裂隙迹线被裁剪至宿主几何体并转换为显式网格边,同时保留父子关系以在最终网格中维持裂隙组身份标识。候选筛选与短段过滤为锐角相交、窄间距和小裁剪碎片提供了控制手段。代表性算例表明,OpenDFN能够在保持既定裂隙几何的同时生成网格,并支持独立的网格质量评估。OpenDFN为FDEM及其他需要显式裂隙表征的数值方法提供了一条可复现且可检查的预处理路径。
OpenDFN:面向离散裂隙网络数值模拟的几何到网格转换预处理框架解读
一、研究背景与问题
节理、层理面、断层及其他不连续结构面直接影响裂隙岩体的变形、破坏和流体输运行为。传统连续介质方法通常通过等效材料参数来考虑这些不连续面的影响,因而只能描述岩体的平均响应,无法直接再现单个裂隙在张开、闭合、滑动和扩展过程中的局部力学行为。当研究裂隙起裂、贯通和相互作用时,需要采用能够显式表征裂隙及其分离行为的数值方法。有限-离散元法(FDEM)是代表性方法之一,可在统一计算框架内描述连续体变形、裂隙扩展和块体接触。
在实际应用中,裂隙描述可能来自测线调查、基于图像的制图或统计节理系统模型。现有软件覆盖了DFN建模流程的不同阶段:dfnWorks集成了三维随机DFN生成、保形网格划分、流动与输运分析;UnBlocksgen专注于从随机不连续面生成三维岩块系统;ADFNE提供二维和三维DFN生成与分析工具;HATCHFRAC用于快速开源DFN生成;FracMan和3DEC则提供更广泛的商业工作流。然而,现有工具在维度、输入类型和下游应用方面存在差异,缺乏一个轻量级的二维统一工作流来同时处理确定性节理、连续或非连续节理组、随机裂隙网络和坐标导出裂隙折线。此外,原始裂隙与生成的子曲线之间的对应关系在裁剪、相交和几何碎片化后可能难以保留,限制了裂隙组身份标识在后续网格划分和数值分析中的使用。这些局限性促使研究人员开发一个能够统一不同裂隙输入、执行几何到网格转换并保留裂隙组身份标识的二维预处理工具。
二、研究内容与主要结论
OpenDFN提供了一个统一的二维预处理框架,可处理确定性节理、连续和非连续节理组、随机DFN以及坐标导出的裂隙折线,并可与基本域和开挖几何体在同一模型中组合。该软件基于Gmsh/OpenCASCADE构建,将输入几何转换为裂隙保形网格,同时保留原始裂隙与几何处理过程中生成的子曲线之间的对应关系,使裂隙组身份标识能够传递至最终网格。工作流还包括几何质量控制,用于筛选可能导致网格问题的构型并移除过短的裂隙碎片。
代表性算例验证了该工作流的适用性:确定性节理可直接转换为保形网格;连续节理组可生成相交的裂隙族并保留父组身份标识;非连续节理组可表示由完整岩桥分隔的非贯通裂隙;随机DFN可生成400条裂隙的保形Delaunay网格;坐标驱动的真实DFN可处理分别包含544条和450条迹线的两个映射网络。网格质量评估表明,几何筛选和短片段过滤有效抑制了严重畸变三角形单元的产生。对于随机DFN,最小内角低于20°的三角形比例从不加过滤时的0.8358%降至过滤后的0.0035%;两个映射网络区域的相应比例也分别从1.5625%降至1.1259%和从1.3082%降至0.8493%。平均归一化形状度量qe在各案例中均有所提高。
三、关键技术与方法
研究人员开发了OpenDFN,一个基于CMake构建的命令行可执行程序opendfn,采用C++20实现并链接Gmsh 5.0 SDK。其核心技术方法包括:基于Gmsh/OpenCASCADE的几何到网格流水线,通过布尔运算实现裂隙嵌入;随机裂隙生成方法,采用中心、方位角和长度的采样策略;结构化节理组生成方法,通过参考点推进和间距增量构建连续或非连续节理;几何筛选与短段过滤的两阶段质量控制机制。随机数使用C++标准库生成。算例中的坐标驱动DFN数据来自FracPaQ研究的源照片,裂隙迹线在OpenDFN外部识别和数字化后以坐标折线文件形式输入。
四、研究结果
4.1 连续节理组
确定性节理案例通过端点坐标直接插入预定裂隙,验证了基本的几何到网格操作。10 m×10 m方形宿主域内,预定迹线作为宿主表面的内部边界被保留,相邻三角形单元共享其节点。连续节理组案例使用14 m×14 m生成区域构建完整迹线后裁剪至10 m×10 m宿主域。两组节理分别具有35°和125°倾角,间距分别为1.05 m和1.45 m。生成的网格中,两组节理的相交由共享网格节点解析,周围三角形单元同时贴合两个节理族,父组身份标识在裁剪、布尔碎片化和物理组分配过程中得以保留。
4.2 非连续节理组
非连续节理组用于表示由完整岩桥分隔的非贯通裂隙。两组节理的倾角分别为35°和125°,法向间距分别为0.78 m和1.10 m,活动迹线长度分别为1.20 m和0.92 m,完整间隙长度分别为0.42 m和0.62 m。单组案例中,活动段沿一个方向被完整区域分隔;双组案例引入了族间相交,同时将间隙保留为未破裂岩石。保形网格沿保留的活动段生成,两个裂隙族在相交和曲线碎片化后仍可通过物理组标签区分。
4.3 随机裂隙网络
随机案例在10 m×10 m方形宿主域内评估一个裂隙总体,目标为400条接受裂隙。倾角在0°至45°间均匀采样,裂隙长度服从均值0.90 m、标准差0.90 m的正态分布。候选迹线在插入前经过筛选,裁剪至宿主域后嵌入表面网格。生成的网格中裂隙迹线以内部网格边显式表示,放大视图显示三角形网格解析了裂隙端点和交点,相交迹线处具有共享节点。长度加权玫瑰图描述了累积迹线长度的方向分布,实现迹线长度分布和倾角频率密度均在规定的0°至45°范围内。
4.4 坐标驱动的真实DFN
研究人员从FracPaQ研究的源照片中选择两个矩形区域,分别包含544条和450条迹线。以约120像素/米的比例尺,两个域分别测量为23.708 m×28.9 m和22.708 m×26.6 m。OpenDFN导入坐标折线后,使用相同的边界裁剪、布尔碎片化、物理组分配和Delaunay网格划分程序处理两个网络。两个网格分别包含18,306个节点和36,239个三角形,以及14,900个节点和29,436个三角形,表明同一预处理工作流可适应不同几何和密度的映射网络。
4.5 网格质量评估
研究人员使用最小内角和归一化形状度量qe评估网格质量,其中qe = 4√3Ae/(ae2 + be2 + ce2),等边三角形qe = 1,退化三角形趋近于0。对随机DFN和两个图像导出DFN,比较了过滤和未过滤预处理结果。该方法主要降低低质量尾部:随机DFN中最小内角低于20°的三角形比例从0.8358%降至0.0035%,平均qe从0.930增至0.944;区域1和区域2的相应比例分别从1.5625%降至1.1259%和从1.3082%降至0.8493%,平均qe分别从0.913增至0.918和从0.918增至0.923。
五、讨论与结论
OpenDFN解决了基于裂隙的数值建模中的实际瓶颈:将不同来源的裂隙信息转换为可直接用于数值分析的计算表示。裂隙迹线可能来自野外制图、钻孔解释、实验室成像或统计生成,而下游应用可能要求在计算网格中显式表示单个裂隙及其连通性。OpenDFN为这些情况提供了统一的预处理路径,减少了对不同裂隙描述分别开发几何准备和网格划分程序的需求。该工作流对FDEM及其他需要显式表征裂隙位置和连通性的数值方法尤为有用。统一的几何表示还便于在不同分析间复用裂隙模型。
OpenDFN提供了一条开源工作流,可将不同离散裂隙描述转换为二维裂隙保形网格。确定性节理、连续和非连续节理组、随机DFN以及坐标驱动的裂隙折线可在统一几何结构中处理,并与基本域和开挖几何体组合。基于Gmsh/OpenCASCADE的工作流在几何构建和网格生成过程中保持裂隙几何和裂隙组信息。候选筛选、几何控制和短段过滤提供了减少可避免的低质量网格特征的实际手段。当前版本聚焦于二维裂隙网络和三角形表面网格,在此范围内,OpenDFN为FDEM及相关数值工作流提供了可复现且可检查的预处理组件。