ADFNE

Alghalandis Discrete Fracture Network Engineering (ADFNE)

ADFNE series are packages of computer codes in Matlab language syntax which consist of

  • functions to generate fracture networks in two and three dimensions based on stochastic modeling principals
  • functions to characterize synthesized or imported two- and three-dimensional fracture networks
    • intersection analysis
    • density measures
    • connectivity (index, field)
    • clustering
    • many other
  • functions for quality visualization of two- and three-dimensional fracture networks
  • functions to generically utilize the above stages and to extend their use for practical applications

to provide stable framework for further developments. They also offer tools to save the resulting graphics, tables and information in common formats. 

ADFNE series are

  • Optimized for Performance
  • Easy to Understand Code
  • Portable
  • 2D and 3D

ADFNE1.5 is the most advanced, comprehensive, full documented and tested edition in ADFNE series.

The development of ADFNE series was initiated in 2011 based on my thorough work, PhD study. I first released AFNM package (Alghalandis Fracture Network Modeling) as part of my PhD thesis in the appendices in 2014, on which I based the development of ADFNE series. By late 2016 I published an initial edition of ADFNE 1.0 which quickly became a fairly complete set of several hundreds functions. In 2017, I released ADFNE1.0 formally with accompanying paper in Journal of Computers & Geosciences.

Reference

Fadakar-A Y (2017) "ADFNE: Open Source Software for Discrete Fracture Network Engineering, Two and Three Dimensional Applications", Journal of Computers and Geosciences, 102:1-11. DOI: http://dx.doi.org/10.1016/j.cageo.2017.02.002

Gallery
ADFNE 1.0 License

Copyright (c) 2011-2017, Younes Fadakar Alghalandis, Alghalandis Computing @

{http://alghalandis.net} All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
* Name of the Author (copyright holder) cannot be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The Source Code of ADFNE 1.0 (1.1, 285+ functions) is available on Github.

To use ADFNE 1.0 or 1.1 please download the following packages/single files as well. Release 1.1 may contain incomplete updated functions.

A couple of external Matlab single codes or packages are linked here without inclusion of their code including geom2d and geom3d (edition 2011, by David Legland), circstat (edition 2011, by Philipp Berens), kde2d.m (edition 2009, by Zdravko Botev), smoothn.m (edition 2010, by Damien Garcia), vol3d.m (edition 2009, by Oliver Woodford), and dict.m (edition 2008, by Doug Harriman).

Through ADFNE1.0 and 1.1 the following renaming for few functions is in place.

  • “Dict”  = “dict”
  • “Smooth” = “smoothn”
  • “KDE” = “kde2d”
  • “Vol3” = “vol3d”

geom2d —- http://www.mathworks.com.au/matlabcentral/fileexchange/7844-geom2d
geom3d —- http://www.mathworks.com.au/matlabcentral/fileexchange/24484-geom3d
circstat —- http://www.mathworks.com.au/matlabcentral/fileexchange/10676-circular-statistics-toolbox-directional-statistics
kde2d.m —- http://www.mathworks.com.au/matlabcentral/fileexchange/17204-kernel-density-estimation
smoothn.m —- http://www.mathworks.com.au/matlabcentral/fileexchange/25634-easy-n-fast-smoothing-for-1-d-to-n-d-data
vol3d.m —- http://www.mathworks.com.au/matlabcentral/fileexchange/22940-vol3d-v2
dict.m —- http://www.mathworks.com.au/matlabcentral/fileexchange/19647-dict

Important Note

I strongly recommend the use of advanced and newer edition, ADFNE1.5, instead of 1.0 or 1.1 for the following benefits.

ADFNE1.5 is

  • a complete package,
  • fully tested,
  • fully documented,
  • totally independent (no third party is required),
  • fully generic coding,
  • impressively easy to use,
  • significantly ready for future development.

ADFNE1.5 provides versatile functionalities such as:

  • full simulations
  • both 2D and 3D DFN models
  • any shape of fractures (3D: random, polygon, ellipse etc.)
  • multiple sets
  • full characterizations
  • full applications
  • fluid flow through DFN (2D and 3D)
  • impressive visualizations
  • exports (TXT, WebGL, INP, GEO, VTK, SVG, …)
1 – read the paper:

Fadakar-A Y (2017) “ADFNE: Open Source Software for Discrete Fracture Network Engineering, Two and Three Dimensional Applications”, Journal of Computers and Geosciences, 102:1-11. DOI

2 – study the book “DFNE Practices with ADFNE”

This book is a 61-page manual book for ADFNE1.5 covering all functions in the package (formal syntax, use form, examples, descriptions, hints etc.). It also includes 17 full case studies. This book is professionally designed and is included in ADFNE1.5 package for free.