Package to help analyze fracture patterns on broken glass plys.
Project description
For citation please use:
@software{fracture-suite, author = {Leon Bohmann}, title = {fracsuite v0.2.0}, data = 2024-02, version = {0.2.0}, doi = {10.5281/zenodo.10700742}, url = {https://doi.org/10.5281/zenodo.10700742} }
How it works
:warning: This is deprecated. The documentation will be updated in the future!
Several steps are necessary to analyze a fracture scan:
- Cropping of input image (optional)
- Analyze the image and find the biggest rectangular shape
- Perspective transform the image, so that the rectangle is filling the extents
- Preprocessing
- Gaussian Blur + (optional) Resize of the input image
- Adaptive Threshold
- Contour detection
- Find all contours on the preprocessed image
- Filter Contours, remove all:
- Whose perimeter is too small
- Whose area is way too large (25000px²)
- Create stencil with the found contours
- This helps to quickly remove all contours that lie within a bigger contour
- Draw all contours onto a new image (resulting image will display the cracks)
- Skeletonization #1
- Skeletonize the stencil to minimize the crack width to 1px wide lines
- Use Erode/Dilate (closing kernel) to connect gaps in contours (this will widen the 1px wide lines)
- Skeletonization #2
- Skeletonize the image again to retrieve the crack middle lines
- (enabled by default) Remove splinters, whose are is all black in the original image and fill those spaces
- Contour detection #2
- Now with minimal fuzziness, run the splinter detection again
- Create splinters from resulting contour list
A couple of outputs are saved to a directory next to the input image. These are:
- Contour plot of recognized splinters (you have to zoom in, contour thickness is 1px)
- Filled plot of splinters
- Figures
- Splinter size distribution
- Splinter relative share distribution
- Voronoi overview
- Fracture Intensity overlay
Installation
pip install fracsuite
Usage (:warning: 0.1.7 only!)
Use the module directly
py -m fracsuite.splinters "path/to/image"
For details see: API Docs
Create a script
from fracsuite.splinters.analyzer import Analyzer, AnalyzerConfig
image = r"Path/to/some/image.bmp"
config = AnalyzerConfig()
# size of cropped image (if cropping is needed)
config.cropsize = (4000,4000)
analyzer = Analyzer(image, config)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
fracsuite-1.0.0.tar.gz
(202.6 kB
view hashes)
Built Distribution
fracsuite-1.0.0-py3-none-any.whl
(226.5 kB
view hashes)
Close
Hashes for fracsuite-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f2b11cf59b88440722a8e8676ac1fb6e2566d8fbff6292d40c80d4a2c6b47435 |
|
MD5 | 99f3bd88e1d3be5d49a969ed1b51bb39 |
|
BLAKE2b-256 | 136f664a3fe5f59732b3024e0ce8ad8635312933954d04f67c9d6e12c3afdb72 |