<div align="center">
![](./docs/images/logo_small_small.png)
[![GitHub release](https://img.shields.io/github/release/gbene/FracAbility?&sort=semver&color=orange)](https://github.com/gbene/FracAbility/releases/)
[![License](https://img.shields.io/badge/License-AGPL--3.0-orange)](#license)
[![issues - FracAbility](https://img.shields.io/github/issues/gbene/FracAbility)](https://github.com/gbene/FracAbility/issues)
[![Made with Python](https://img.shields.io/badge/Python->=3.8-orange?logo=python&logoColor=white)](https://python.org "Go to Python homepage")
![maintained - yes](https://img.shields.io/badge/maintained-yes-green)
</div>
**FracAbility** is a Python toolbox that can be used to analyse fracture networks in digitalized rock
outcrops. This package provides tools to:
1. Define the topology of fracture networks
2. Statistically analyze fracture length distributions while taking into consideration
right censoring effects ([survival analysis](https://en.wikipedia.org/wiki/Survival_analysis)).
The name Frac**Ability** recalls the [reliability](https://github.com/MatthewReid854/reliability/tree/master)<sup>1</sup>
library that inspired and helped in the creation of this project.
## Quick introduction ⚡
Fracture networks are essential for the analysis and modelling of mechanical and hydraulic properties
of rock masses. Recently, the use of Digital Outcrop Models (**DOMs**) provided a solid framework for the collection
of large and quantitative datasets from which different properties can be extracted.
Because of the complex nature of exposed rock outcrops, statistical model fitting can sometimes be challenging.
Areas covered by rock debree, vegetation patches or simply the outer boundaries of the outcrop can
introduce right-censoring bias and can often lead to parameter underestimation.
The following diagram represents an idealized rock outcrop. We can define the wider rectangle as the entire
fractured object while the smaller one as the outcrop that we can see and measure. We can immediately
see what is going wrong; many of the fractures that we can measure are incomplete thus leading to underestimate
fracture length.
![](./docs/images/example_diagram.png)
Tools are needed to correct for this bias. Survival analysis techniques, although usually applied
in function of time and not space, accomplishes exactly this.
## Features 📋
- **Shapefile importing support**
- **Rapid topology analysis and identification of I,Y,X and U nodes**
- **Backbone(s) identification**
- **Statistical analysis tools:**
+ Empirical CDF and SF calculation
+ Distribution fitting
+ Statistical model testing
- **Plotting tools:**
+ Network objects plotting using matplotlib or vtk
+ Ternary node plot
+ Rose diagram
+ Statistical plotting
## Installation 🔧
To install fracability pip can be used:
```bash
pip install fracability
```
## Documentation
For usage details please refer to the documentation:
[![View - Online docs](https://img.shields.io/badge/View-Online_docs-blue?style=for-the-badge)](https://fracability.readthedocs.io/en/latest/index.html "Go to online documentation")
[![view - Documentation](https://img.shields.io/badge/view-Documentation-blue?style=for-the-badge)](/docs/ "Go to project documentation")
## References 🎓
1. Reid, M. (2020). MatthewReid854/reliability: v0. 5.1. version v0, 5.
## License
Released under [AGPL-3.0](/LICENSE) by [@gbene](https://github.com/gbene)
Raw data
{
"_id": null,
"home_page": "https://github.com/gbene/FracAbility",
"name": "FracAbility",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "topology earth-science survival-analysis fracture-networks",
"author": "Gabriele Benedetti",
"author_email": "gabri.benedetti@gmail.com",
"download_url": null,
"platform": null,
"description": "\n<div align=\"center\">\n\n![](./docs/images/logo_small_small.png)\n\n[![GitHub release](https://img.shields.io/github/release/gbene/FracAbility?&sort=semver&color=orange)](https://github.com/gbene/FracAbility/releases/)\n[![License](https://img.shields.io/badge/License-AGPL--3.0-orange)](#license)\n[![issues - FracAbility](https://img.shields.io/github/issues/gbene/FracAbility)](https://github.com/gbene/FracAbility/issues)\n[![Made with Python](https://img.shields.io/badge/Python->=3.8-orange?logo=python&logoColor=white)](https://python.org \"Go to Python homepage\")\n![maintained - yes](https://img.shields.io/badge/maintained-yes-green)\n</div>\n\n**FracAbility** is a Python toolbox that can be used to analyse fracture networks in digitalized rock\noutcrops. This package provides tools to:\n\n1. Define the topology of fracture networks \n2. Statistically analyze fracture length distributions while taking into consideration \nright censoring effects ([survival analysis](https://en.wikipedia.org/wiki/Survival_analysis)). \n\nThe name Frac**Ability** recalls the [reliability](https://github.com/MatthewReid854/reliability/tree/master)<sup>1</sup> \nlibrary that inspired and helped in the creation of this project. \n\n\n## Quick introduction \u26a1\n\nFracture networks are essential for the analysis and modelling of mechanical and hydraulic properties \nof rock masses. Recently, the use of Digital Outcrop Models (**DOMs**) provided a solid framework for the collection \nof large and quantitative datasets from which different properties can be extracted.\nBecause of the complex nature of exposed rock outcrops, statistical model fitting can sometimes be challenging. \nAreas covered by rock debree, vegetation patches or simply the outer boundaries of the outcrop can \nintroduce right-censoring bias and can often lead to parameter underestimation.\n\nThe following diagram represents an idealized rock outcrop. We can define the wider rectangle as the entire \nfractured object while the smaller one as the outcrop that we can see and measure. We can immediately \nsee what is going wrong; many of the fractures that we can measure are incomplete thus leading to underestimate \nfracture length. \n\n![](./docs/images/example_diagram.png)\n\nTools are needed to correct for this bias. Survival analysis techniques, although usually applied \nin function of time and not space, accomplishes exactly this.\n\n## Features \ud83d\udccb\n\n- **Shapefile importing support**\n\n\n- **Rapid topology analysis and identification of I,Y,X and U nodes**\n\n\n- **Backbone(s) identification**\n\n\n- **Statistical analysis tools:**\n + Empirical CDF and SF calculation\n + Distribution fitting\n + Statistical model testing\n\n\n- **Plotting tools:**\n + Network objects plotting using matplotlib or vtk\n + Ternary node plot \n + Rose diagram\n + Statistical plotting\n\n## Installation \ud83d\udd27\n\nTo install fracability pip can be used:\n\n```bash\npip install fracability\n```\n\n## Documentation\n\nFor usage details please refer to the documentation:\n\n[![View - Online docs](https://img.shields.io/badge/View-Online_docs-blue?style=for-the-badge)](https://fracability.readthedocs.io/en/latest/index.html \"Go to online documentation\")\n\n[![view - Documentation](https://img.shields.io/badge/view-Documentation-blue?style=for-the-badge)](/docs/ \"Go to project documentation\")\n\n\n\n## References \ud83c\udf93\n\n1. Reid, M. (2020). MatthewReid854/reliability: v0. 5.1. version v0, 5.\n\n\n## License\n\nReleased under [AGPL-3.0](/LICENSE) by [@gbene](https://github.com/gbene)\n",
"bugtrack_url": null,
"license": null,
"summary": "Python toolbox used to analyse fracture networks for digitalized rock outcrops.",
"version": "1.2.1",
"project_urls": {
"Homepage": "https://github.com/gbene/FracAbility",
"changelog": "https://github.com/gbene/FracAbility/releases",
"documentation": "https://fracability.readthedocs.io/en/latest/index.html",
"tracker": "https://github.com/gbene/FracAbility/issues"
},
"split_keywords": [
"topology",
"earth-science",
"survival-analysis",
"fracture-networks"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6417ed22cefef40255aa678042a45fae9c1e6fa87ec73fef58dc950e14cdf805",
"md5": "2edfc9d4fce3f52ed68f80ba8292492b",
"sha256": "4e15de9696a5935ebb5a150892c559ff688966e0bfe2286845d59266a23812cd"
},
"downloads": -1,
"filename": "FracAbility-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2edfc9d4fce3f52ed68f80ba8292492b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 32277,
"upload_time": "2024-04-22T18:47:21",
"upload_time_iso_8601": "2024-04-22T18:47:21.964930Z",
"url": "https://files.pythonhosted.org/packages/64/17/ed22cefef40255aa678042a45fae9c1e6fa87ec73fef58dc950e14cdf805/FracAbility-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-22 18:47:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gbene",
"github_project": "FracAbility",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "fracability"
}