/measure_hydrate_layer

Primary LanguageJupyter NotebookGNU General Public License v3.0GPL-3.0

Measure hydrate layer

A python script to measure the thickness of the C-S-H layer around alite (C3S) or belite (C2S) particles. This script is part of the paper "A python tool to determine the thickness of the hydrate layer around clinker grains using SEM-BSE images.", (to be) published for the 19th Euroseminar on Microscopy Applied to Building Materials 2024. The preprint is available at

Open the Jupyter notebook cement_hydrate_fringe_C3S 7d-example.ipynb to see an exaple on how to process the datasets. The notebook final_evaluation_C3S.ipynb includes some postprocessing/evaluation of the preprocessed datasets.

datasets

The datasets processed using this script and mentioned in the corresponding paper are available at Zenodo:

  • C3S (1,7,14, 28, 84, and 365 days) DOI
  • C2S (14, 28, 84, and 365 days) DOI
  • C3S (14 days, reduced resolution, segmented) DOI

The datasets should be saved in the following folder structure:

[tiff_scaling]
├── [C3S]
│   ├── [1d]
│   │   └── C3S 1d.tif
│   ├── [7d]
│   │   ├── 7d_example.tif
│   │   ├── C3S 7d.tif
│   │   └── C3S 7d_2.tif
│   ├── [14d]
│   │   ├── [guided_segmentation]
│   │   │   ├── C3S.tif
│   │   │   ├── CH.tif
│   │   │   ├── CSH.tif
│   │   │   └── pores.tif
│   │   ├── ...
│   │   ├── C3S 14d.tif
│   │   └── C3S 14d_half-resolution.tif
│   └── ...
├── [C2S]
│   └── ...
└── *.*

required packages

This project was written with Python 3.10 and Jupyter notebooks in mind. Since Python 3.11 provides some significant performance improvements, it is recommended to use this version or newer.

The project depends on another repository. Just clone it to the same parent folder as this project.

git clone https://github.com/kleinerELM/tiff_scaling.git

The folder structure for the scripts should look somewhat like this:

[.]
├── [tiff_scaling]
│   └── ...
└── [measure_hydrate_layer]
    └── ...

Additionally, some third-party packages are required.

pip You can install them either using pip:

pip install -r requirements-pip.txt

(Ana)conda or using Anaconda. First switch to the desired environment (here py311):

conda activate py311

and then install the required packages:

conda install --yes --file requirements.txt