<div align="center">
[](https://github.com/gbene/FracAbility/releases/)
[](#license)
[](https://github.com/gbene/FracAbility/issues)
[](https://python.org "Go to Python homepage")
</div>
## 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. Tools are needed to correct for estimating the correct distribution parameters while taking into account this bias. Survival analysis techniques, although usually applied in function of time and not length, accomplishes exactly this.
**FracAbility** is a Python toolbox that can be used to analyse fracture networks and estimate length distributions considering and correcting the effect of right-censoring using survival analysis. This package provides tools to:
1. Define the topology of fracture networks
2. Estimate multiple fracture length distributions while taking into consideration
right censoring effects.
3. Provide methods to choose the most representative distribution using both a visual and a quantitative approach
Please refer to the [Docs](https://fracability.readthedocs.io/en/latest/) for a more in depth introduction to the problem, theoretical background, examples and API overview.
## Installation 🔧
To install FracAbility **pip** can be used:
```bash
pip install fracability
```
Please refer to the [Docs](https://fracability.readthedocs.io/en/latest/Quickstart.html) for further guidance
## Documentation 📚
Click here to view the online documentation:
[](https://fracability.readthedocs.io/en/latest/index.html "Go to online documentation")
Click here to view the source code for the documentation:
[](/docs/ "Go to project documentation")
## Authors 💎✨
+ **Gabriele Benedetti** ([gabri.benedetti@gmail.com](mailto:gabri.benedetti@gmail.com))
+ Stefano Casiraghi ([s.casiraghi21@campus.unimib.it](mailto:s.casiraghi21@campus.unimib.it))
+ Daniela Bertacchi ([daniela.bertacchi@unimib.it](mailto:daniela.bertacchi@unimib.it))
+ Andrea Bistacchi ([andrea.bistacchi@unimib.it](mailto:andrea.bistacchi@unimib.it))
## License 📄
Released under [AGPL-3.0](/LICENSE) by [@gbene](https://github.com/gbene)
Raw data
{
"_id": null,
"home_page": null,
"name": "FracAbility",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "DOM, censoring, fractures, fracture-networks, survival-analysis, reliability",
"author": null,
"author_email": "Gabriele Benedetti <gabri.benedetti@gmail.com>, Stefano Casiraghi <s.casiraghi21@campus.unimib.it>, Daniela Bertacchi <daniela.bertacchi@unimib.it>, Andrea Bistacchi <andrea.bistacchi@unimib.it>",
"download_url": "https://files.pythonhosted.org/packages/5e/d0/679c3bc897226134a87c5860e9897acc4bb4a4f95645b790d3bb457f40df/fracability-1.4.0.tar.gz",
"platform": null,
"description": "\n<div align=\"center\">\n\n\n\n[](https://github.com/gbene/FracAbility/releases/)\n[](#license)\n[](https://github.com/gbene/FracAbility/issues)\n[](https://python.org \"Go to Python homepage\")\n\n</div>\n\n## Quick introduction \u26a1\n\n\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. Tools are needed to correct for estimating the correct distribution parameters while taking into account this bias. Survival analysis techniques, although usually applied in function of time and not length, accomplishes exactly this.\n\n**FracAbility** is a Python toolbox that can be used to analyse fracture networks and estimate length distributions considering and correcting the effect of right-censoring using survival analysis. This package provides tools to:\n\n1. Define the topology of fracture networks \n2. Estimate multiple fracture length distributions while taking into consideration \nright censoring effects. \n3. Provide methods to choose the most representative distribution using both a visual and a quantitative approach \n\nPlease refer to the [Docs](https://fracability.readthedocs.io/en/latest/) for a more in depth introduction to the problem, theoretical background, examples and API overview. \n\n## Installation \ud83d\udd27\n\nTo install FracAbility **pip** can be used:\n\n```bash\npip install fracability\n```\n\nPlease refer to the [Docs](https://fracability.readthedocs.io/en/latest/Quickstart.html) for further guidance\n\n## Documentation \ud83d\udcda\n\nClick here to view the online documentation:\n\n[](https://fracability.readthedocs.io/en/latest/index.html \"Go to online documentation\")\n\nClick here to view the source code for the documentation:\n\n[](/docs/ \"Go to project documentation\")\n\n\n## Authors \ud83d\udc8e\u2728\n\n + **Gabriele Benedetti** ([gabri.benedetti@gmail.com](mailto:gabri.benedetti@gmail.com))\n + Stefano Casiraghi ([s.casiraghi21@campus.unimib.it](mailto:s.casiraghi21@campus.unimib.it))\n + Daniela Bertacchi ([daniela.bertacchi@unimib.it](mailto:daniela.bertacchi@unimib.it))\n + Andrea Bistacchi ([andrea.bistacchi@unimib.it](mailto:andrea.bistacchi@unimib.it))\n\n## License \ud83d\udcc4\n\nReleased under [AGPL-3.0](/LICENSE) by [@gbene](https://github.com/gbene)\n",
"bugtrack_url": null,
"license": "AGPL-3.0 license",
"summary": "Analyse fracture networks for digitalized rock outcrops.",
"version": "1.4.0",
"project_urls": {
"Bug Tracker": "https://github.com/gbene/FracAbility/issues",
"Documentation": "https://fracability.readthedocs.io/en/latest/index.html",
"Source Code": "https://github.com/gbene/FracAbility"
},
"split_keywords": [
"dom",
" censoring",
" fractures",
" fracture-networks",
" survival-analysis",
" reliability"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7f1665b60174f3c7e959f1e64d06c8398bffb68ffb60b3be82ed5b6d307ed260",
"md5": "37bac563ed9fbd474d78399a68d78e3b",
"sha256": "5041c0aa70a1850c9483a961b0b2015bf01444a2654c31141344c9a1ae6198b7"
},
"downloads": -1,
"filename": "FracAbility-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "37bac563ed9fbd474d78399a68d78e3b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 3187119,
"upload_time": "2024-06-20T12:40:25",
"upload_time_iso_8601": "2024-06-20T12:40:25.484114Z",
"url": "https://files.pythonhosted.org/packages/7f/16/65b60174f3c7e959f1e64d06c8398bffb68ffb60b3be82ed5b6d307ed260/FracAbility-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5ed0679c3bc897226134a87c5860e9897acc4bb4a4f95645b790d3bb457f40df",
"md5": "97c4acf31f59fd2de1493d74b893b048",
"sha256": "dff65071d3d6c2f235b9dce3e036652409dc54cb318145be55e6b0f6cc3943a1"
},
"downloads": -1,
"filename": "fracability-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "97c4acf31f59fd2de1493d74b893b048",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 3173252,
"upload_time": "2024-06-20T12:40:27",
"upload_time_iso_8601": "2024-06-20T12:40:27.397087Z",
"url": "https://files.pythonhosted.org/packages/5e/d0/679c3bc897226134a87c5860e9897acc4bb4a4f95645b790d3bb457f40df/fracability-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-20 12:40:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gbene",
"github_project": "FracAbility",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "geopandas",
"specs": [
[
"==",
"0.9.0"
]
]
},
{
"name": "matplotlib",
"specs": [
[
"==",
"3.7.1"
]
]
},
{
"name": "networkx",
"specs": [
[
"==",
"2.8.4"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"1.25.0"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"1.5.3"
]
]
},
{
"name": "pyperclip",
"specs": [
[
"==",
"1.8.2"
]
]
},
{
"name": "pytest",
"specs": [
[
"==",
"7.4.3"
]
]
},
{
"name": "python_ternary",
"specs": [
[
"==",
"1.0.8"
]
]
},
{
"name": "pyvista",
"specs": [
[
"==",
"0.39.1"
]
]
},
{
"name": "scipy",
"specs": [
[
"==",
"1.11.4"
]
]
},
{
"name": "scooby",
"specs": [
[
"==",
"0.7.2"
]
]
},
{
"name": "seaborn",
"specs": [
[
"==",
"0.13.0"
]
]
},
{
"name": "Shapely",
"specs": [
[
"==",
"2.0.2"
]
]
},
{
"name": "vtk",
"specs": [
[
"==",
"9.2.6"
]
]
},
{
"name": "sphinx",
"specs": []
},
{
"name": "sphinx_book_theme",
"specs": []
},
{
"name": "sphinx-autobuild",
"specs": []
},
{
"name": "trame",
"specs": []
}
],
"lcname": "fracability"
}
JSON
