Checking for non-preferred file/folder path names (may take a long time depending on the number of files/folders) ...

This resource contains some files/folders that have non-preferred characters in their name. Show non-conforming files/folders.

This resource contains content types with files that need to be updated to match with metadata changes. Show content type files that need updating.

Data and code repository for From points to planes: A workflow for converting three-dimensional point cloud data into discrete fracture network flow and transport models

Authors:
Owners:		This resource does not have an owner who is an active HydroShare user. Contact CUAHSI (help@cuahsi.org) for information on this resource.
Type:	Resource
Storage:	The size of this resource is 284.3 MB
Created:	Nov 03, 2025 at 6:13 p.m. (UTC)
Last updated:	Mar 23, 2026 at 2:53 p.m. (UTC) (Metadata update)
Published date:	Mar 23, 2026 at 2:53 p.m. (UTC)
DOI:	10.4211/hs.7cfcb78ed48e4281974b206959ed6f23
Citation:	See how to cite this resource

Sharing Status:	Published
Views:	54
Downloads:	3
+1 Votes:	Be the first one to this.
Comments:	No comments (yet)

Abstract

We present the Point cLoud Algorithm for NEtwork Extraction of Discrete Fracture Networks (PLANE-DFN), a point cloud–based algorithm for automatic fracture network extraction designed to support discrete fracture network (DFN) modeling workflows. PLANE-DFN segments three-dimensional fracture planes from raw point cloud data using RANdom SAmple Consensus (RANSAC) coupled with statistical outlier removal and density-based clustering to isolate individual fracture features. Each candidate plane is constrained against site-specific structural constraints based on strike and dip. After segmentation, each fracture is converted into a 2-D convex polygon suitable for meshing and simulation. The PLANE-DFN algorithm is validated by comparing geometric and flow and transport data against data from dfnWorks simulations with ensembles of plane-fit networks. We find that the flow and transport in plane-fit networks are comparable to dfnWorks-generated networks when realistic network geometry is maintained. The PLANE-DFN algorithm provides an automated and streamlined workflow to transform point clouds of data into DFN network geometry.

Subject Keywords

Content

Learn more about the BagIt download

Select a file to see file type metadata.

readme.txt

This is a repository for the PLANE-DFN algorithm and supporting files used in From points to planes: A workflow for converting three-dimensional point cloud data into discrete fracture network flow and transport models submitted to Water Resources Research.

The .zip file contains 4 directories: 4fracture, 4fracture_truth, 14fracture, and 14fracture_truth. These directories contain the necessary supporting files to run each plane fitting and dfnWorks models. The .zip file also contains 3 .py files which are the PLANE-DFN segmentation script, the PLANE-DFN segmentation helper file, and the dfnWorks script to run ensembles.

*These models utilize dfnWorks, LaGrit, and PFLOTRAN. Please navigate to https://dfnworks.lanl.gov/ or https://lanl.github.io/dfnWorks/intro.html for information on installing these softwares. All code was designed and ran on Docker Desktop with a dfnWorks image, but are designed to run on Mac/Linux as well.
To operate truth dfnWorks code:
1) Navigate to the *_truth directories and inspect the driver.py files. Ensure the proper path to your downloaded PLANE-DFN directory is set in each file.
2) Run the dfnWorks truth models by calling $ python driver.py in each directory
3) The particle transport output is in the partime.dat files in the output directory for each model
To operate PLANE-DFN code:
1) Open and ensure paths are set to your downloaded PLANE-DFN directory in PLANE-DFN_planeSegmentation_script.py and PLANE-DFN_dfnWorks_script.py.
2) PLANE-DFN_planeSegmentation_script.py is the script used for RANSAC plane segmentation. Default settings are for the 14-fracture network. Please check code and comment/uncomment lines if using the 4-fracture network.
3) Running the PLANE-DFN_planeSegmentation_script.py will create subdirectories in the specified 4fracture or 14fracture directory with the necessary files for a dfnWorks model.
4) Run PLANE-DFN_dfnWorks_script.py after checking the variables and paths. This will create the partime.dat files for particle transport. The code will clean and remove most output files to preserve disk space.
The following software versions were used for developing and running the code used in this study:
Python - 3.8.19
Open3d - 0.19.0
dfnWorks - 2.9.1
PFLOTRAN 4.0
LaGrit - 3.3.4

Credits

Funding Agencies

This resource was created using funding from the following sources:

Agency Name	Award Title	Award Number
United States Department of Energy	Center for Understanding Subsurface Signals and Permeability	FWP 81834
U.S. National Science Foundation	None	EAR 2437912
United States Department of Energy	Basic Energy Sciences program	LANLE3W1
United States Department of Energy	Center on Geo-process in Mineral Carbon Storage	DE-SC0023429
United States Department of Energy	Office of Science Graduate Student Research Program	DE-SC0014664

How to Cite

Sutton, C., C. Zahasky, J. D. Hyman, A. A. Pachalieva (2026). Data and code repository for From points to planes: A workflow for converting three-dimensional point cloud data into discrete fracture network flow and transport models, HydroShare, https://doi.org/10.4211/hs.7cfcb78ed48e4281974b206959ed6f23

This resource is shared under the Creative Commons Attribution CC BY.

http://creativecommons.org/licenses/by/4.0/

Comments

There are currently no comments

Notifications (${tasks.length})