revanalyzer


Namerevanalyzer JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
SummaryPackage for representativity analysis of 3D binary images
upload_time2025-02-22 07:26:00
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords 3d images rev image analysis
VCS
bugtrack_url
requirements numpy pandas matplotlib scikit-learn gudhi pyfdmss porespy openpnm pyperspairdiamorse
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # PARSE: Physical Attribute Representativity and Stationarity Evaluator

## General information

PARSE is an open source package for representativity analysis of 3D binary images. It aims at representativity analysis for different scalar and vector metrics. Using PARSE library, one can estimate determenistic and statistical representative elementary volumes (dREV and sREV) for these metrics. Stationarity analysis and comparison of different images using vector metrics are also possible.

Currently, we provide the following metrics for REV analysis:
- Porosity.
- Permeability.
- Euler density.
- Correlation functions (two-point probabilty $S_2$, lineal path function $L_2$, cluster function $C_2$, surface-surface function $F_{ss}$, surface-void function  $F_{sv}$, pore-size function $P$,
chord length function $p$).
- Pore-network model characterstics (pore and throat numbers, pore and throat radii, connectivity, mean pore and throat radii, mean connectivity).
- Persistence diagrams.

## Prerequisites

Python 3.x and Julia 1.x with packages StatsBase.jl, LinearAlgebra.jl, CorrelationFunctions.jl (version=0.11.0)
and EulerCharacteristic.jl should be installed.

## Installation

To install the latest PyPI release as a library run

```
python3 -m pip install revanalyzer
```

or you can clone this repository and run from local folder

```
python3 -m pip install .
```

## Documentation
	
Documentation is available here on
[GitHub Pages](https://fatimp.github.io/REVAnalyzer/index.html).

To build the documentation locally clone this repository, then read /docs/README.md

## Tutorials

Numerous Jupiter notebooks with examples which show the functionality of PARSE library are available here:
-  [REV analysis for porosity](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_porosity.ipynb)
-  [REV analysis for permeability](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_permeability.ipynb)
-  [REV analysis for Euler density](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_Euler.ipynb)
-  [REV analysis for correlation functions](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_CF.ipynb)
-  [REV analysis for pore-network model characteristics](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_PNM_characteristics.ipynb)
-  [REV analysis for persistence diagrams](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_PD.ipynb)
-  [Comparison of two images using vector metric](https://github.com/fatimp/REVAnalyzer/blob/main/examples/image_compare.ipynb)
-  [Stationarity analysis](https://github.com/fatimp/REVAnalyzer/blob/main/examples/stationarity_analysis.ipynb)

## Describing scientific papers

Mathematical backgound for REV analysis, description of metrics used in 'REVAnalyzer' and application evamples with real 
porous image data:

[Andrey S. Zubov, Aleksey N. Khlyupin, Marina V. Karsanina, Kirill M. Gerke (2024). En search for representative elementary volume (REV) within heterogeneous materials: A survey of scalar and vector metrics using porous media as an example. Advances in Water Resources, 19, 104762.](https://www.sciencedirect.com/science/article/abs/pii/S0309170824001490)

## Authors

Andrey S. Zubov, Digital Core group, MIPT.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "revanalyzer",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "3D images, REV, image analysis",
    "author": null,
    "author_email": "Andrey Zubov <zubov.an.se@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/c8/aa/52a9138d03f21211868e654a817e7cdf5cb4a6dc083228585f357f5dda28/revanalyzer-0.1.1.tar.gz",
    "platform": null,
    "description": "# PARSE: Physical Attribute Representativity and Stationarity Evaluator\n\n## General information\n\nPARSE is an open source package for representativity analysis of 3D binary images. It aims at representativity analysis for different scalar and vector metrics. Using PARSE library, one can estimate determenistic and statistical representative elementary volumes (dREV and sREV) for these metrics. Stationarity analysis and comparison of different images using vector metrics are also possible.\n\nCurrently, we provide the following metrics for REV analysis:\n- Porosity.\n- Permeability.\n- Euler density.\n- Correlation functions (two-point probabilty $S_2$, lineal path function $L_2$, cluster function $C_2$, surface-surface function $F_{ss}$, surface-void function  $F_{sv}$, pore-size function $P$,\nchord length function $p$).\n- Pore-network model characterstics (pore and throat numbers, pore and throat radii, connectivity, mean pore and throat radii, mean connectivity).\n- Persistence diagrams.\n\n## Prerequisites\n\nPython 3.x and Julia 1.x with packages StatsBase.jl, LinearAlgebra.jl, CorrelationFunctions.jl (version=0.11.0)\nand EulerCharacteristic.jl should be installed.\n\n## Installation\n\nTo install the latest PyPI release as a library run\n\n```\npython3 -m pip install revanalyzer\n```\n\nor you can clone this repository and run from local folder\n\n```\npython3 -m pip install .\n```\n\n## Documentation\n\t\nDocumentation is available here on\n[GitHub Pages](https://fatimp.github.io/REVAnalyzer/index.html).\n\nTo build the documentation locally clone this repository, then read /docs/README.md\n\n## Tutorials\n\nNumerous Jupiter notebooks with examples which show the functionality of PARSE library are available here:\n-  [REV analysis for porosity](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_porosity.ipynb)\n-  [REV analysis for permeability](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_permeability.ipynb)\n-  [REV analysis for Euler density](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_Euler.ipynb)\n-  [REV analysis for correlation functions](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_CF.ipynb)\n-  [REV analysis for pore-network model characteristics](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_PNM_characteristics.ipynb)\n-  [REV analysis for persistence diagrams](https://github.com/fatimp/REVAnalyzer/blob/main/examples/REV_PD.ipynb)\n-  [Comparison of two images using vector metric](https://github.com/fatimp/REVAnalyzer/blob/main/examples/image_compare.ipynb)\n-  [Stationarity analysis](https://github.com/fatimp/REVAnalyzer/blob/main/examples/stationarity_analysis.ipynb)\n\n## Describing scientific papers\n\nMathematical backgound for REV analysis, description of metrics used in 'REVAnalyzer' and application evamples with real \nporous image data:\n\n[Andrey S. Zubov, Aleksey N. Khlyupin, Marina V. Karsanina, Kirill M. Gerke (2024). En search for representative elementary volume (REV) within heterogeneous materials: A survey of scalar and vector metrics using porous media as an example. Advances in Water Resources, 19, 104762.](https://www.sciencedirect.com/science/article/abs/pii/S0309170824001490)\n\n## Authors\n\nAndrey S. Zubov, Digital Core group, MIPT.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Package for representativity analysis of 3D binary images",
    "version": "0.1.1",
    "project_urls": {
        "Changelog": "https://github.com/fatimp/REVAnalyzer/blob/main/CHANGELOG.md",
        "Documentation": "https://fatimp.github.io/REVAnalyzer/index.html",
        "Repository": "https://github.com/fatimp/REVAnalyzer"
    },
    "split_keywords": [
        "3d images",
        " rev",
        " image analysis"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "2b702b35046403b9918382235d502a0d623cf4c15d4c0020cce7bc53a7046c98",
                "md5": "bce14a4312ebd03f79728cba07747b35",
                "sha256": "984e0176cee7700bd65a5a6ff44e69625a8ff6a35202a38c0dc3e975b2444517"
            },
            "downloads": -1,
            "filename": "revanalyzer-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bce14a4312ebd03f79728cba07747b35",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 35150,
            "upload_time": "2025-02-22T07:25:58",
            "upload_time_iso_8601": "2025-02-22T07:25:58.348357Z",
            "url": "https://files.pythonhosted.org/packages/2b/70/2b35046403b9918382235d502a0d623cf4c15d4c0020cce7bc53a7046c98/revanalyzer-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "c8aa52a9138d03f21211868e654a817e7cdf5cb4a6dc083228585f357f5dda28",
                "md5": "0ccadbd8cfa6380e919afa384fe4c309",
                "sha256": "4fe88b9455c30912bec1f01fd9505dfdc77507d07acae73b5cab20b4e4d9c9f5"
            },
            "downloads": -1,
            "filename": "revanalyzer-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "0ccadbd8cfa6380e919afa384fe4c309",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 20075,
            "upload_time": "2025-02-22T07:26:00",
            "upload_time_iso_8601": "2025-02-22T07:26:00.300003Z",
            "url": "https://files.pythonhosted.org/packages/c8/aa/52a9138d03f21211868e654a817e7cdf5cb4a6dc083228585f357f5dda28/revanalyzer-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-22 07:26:00",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "fatimp",
    "github_project": "REVAnalyzer",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "numpy",
            "specs": []
        },
        {
            "name": "pandas",
            "specs": []
        },
        {
            "name": "matplotlib",
            "specs": []
        },
        {
            "name": "scikit-learn",
            "specs": []
        },
        {
            "name": "gudhi",
            "specs": []
        },
        {
            "name": "pyfdmss",
            "specs": []
        },
        {
            "name": "porespy",
            "specs": []
        },
        {
            "name": "openpnm",
            "specs": []
        },
        {
            "name": "pyperspairdiamorse",
            "specs": []
        }
    ],
    "lcname": "revanalyzer"
}
        
Elapsed time: 1.44280s