Upload model card and dataset checkpoints
Browse files- CHECKSUMS.sha256 +7 -0
- LICENSE +21 -0
- README.md +91 -0
- checkpoint_manifest.json +77 -0
- checkpoints/Aachen-Heerlen/Best_Model.pth +3 -0
- checkpoints/EBC/Best_Model.pth +3 -0
- checkpoints/EMPS/Best_Model.pth +3 -0
- checkpoints/Grain/Best_Model.pth +3 -0
- checkpoints/MetalDAM/Best_Model.pth +3 -0
- checkpoints/Super/Best_Model.pth +3 -0
- checkpoints/UHCS/Best_Model.pth +3 -0
CHECKSUMS.sha256
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
70f3d25e937de33b3aa7480df248f148f515179738051d623d9918ccf338c985 checkpoints/Aachen-Heerlen/Best_Model.pth
|
| 2 |
+
08fdd67970562adf9184486d56f7c1ed1abd6a17ac964b5297e29ee7dcdc3c3c checkpoints/EBC/Best_Model.pth
|
| 3 |
+
f53ce3d927ba10d5d898efd6aa9f78d7a85351057c824e3b4471addaa9e08008 checkpoints/EMPS/Best_Model.pth
|
| 4 |
+
1e8848fc872b36ef9d7c093477a5a92ada47dfb0e468da85e090ce1b36063fd1 checkpoints/Grain/Best_Model.pth
|
| 5 |
+
f957f80232f02aa0a0b615db37412aadf0909ef959fb1defc8a0a351e33c3778 checkpoints/MetalDAM/Best_Model.pth
|
| 6 |
+
2e2800754c8045b361bf9b7c7c690aa83b5817315a225eaafe5f63e30a36490e checkpoints/Super/Best_Model.pth
|
| 7 |
+
ce4392bba3bd6653311b2b925684bbb0758f7aa73336ebd78aa13b30370aa18d checkpoints/UHCS/Best_Model.pth
|
LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
MIT License
|
| 2 |
+
|
| 3 |
+
Copyright (c) 2026 The Material Image Segmentation Benchmark Authors
|
| 4 |
+
|
| 5 |
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
| 6 |
+
of this software and associated documentation files (the "Software"), to deal
|
| 7 |
+
in the Software without restriction, including without limitation the rights
|
| 8 |
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
| 9 |
+
copies of the Software, and to permit persons to whom the Software is
|
| 10 |
+
furnished to do so, subject to the following conditions:
|
| 11 |
+
|
| 12 |
+
The above copyright notice and this permission notice shall be included in all
|
| 13 |
+
copies or substantial portions of the Software.
|
| 14 |
+
|
| 15 |
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
| 16 |
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
| 17 |
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
| 18 |
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
| 19 |
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
| 20 |
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
| 21 |
+
SOFTWARE.
|
README.md
ADDED
|
@@ -0,0 +1,91 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: mit
|
| 3 |
+
library_name: segmentation_models_pytorch
|
| 4 |
+
pipeline_tag: image-segmentation
|
| 5 |
+
tags:
|
| 6 |
+
- semantic-segmentation
|
| 7 |
+
- microstructure
|
| 8 |
+
- materials-science
|
| 9 |
+
- pytorch
|
| 10 |
+
- unet
|
| 11 |
+
---
|
| 12 |
+
|
| 13 |
+
# U-Net for Quantitative Microstructure Segmentation
|
| 14 |
+
|
| 15 |
+
## Model Description
|
| 16 |
+
|
| 17 |
+
This repository contains seven dataset-specific U-Net checkpoints used in a
|
| 18 |
+
benchmark of microstructure segmentation methods. The model is implemented
|
| 19 |
+
with `segmentation_models_pytorch` and uses a ResNet-50 encoder initialized
|
| 20 |
+
from ImageNet weights. Inputs are resized to 512 x 512 pixels and predictions
|
| 21 |
+
are restored to the original image size with nearest-neighbor interpolation.
|
| 22 |
+
|
| 23 |
+
Source code:
|
| 24 |
+
https://github.com/WUT-AI-AI4Mat/microstructure-segmentation-benchmark
|
| 25 |
+
|
| 26 |
+
## Checkpoints
|
| 27 |
+
|
| 28 |
+
| Dataset | Task | Output channels | File |
|
| 29 |
+
| --- | --- | ---: | --- |
|
| 30 |
+
| Aachen-Heerlen | Binary segmentation | 1 | `checkpoints/Aachen-Heerlen/Best_Model.pth` |
|
| 31 |
+
| EMPS | Binary segmentation | 1 | `checkpoints/EMPS/Best_Model.pth` |
|
| 32 |
+
| Grain | Binary segmentation | 1 | `checkpoints/Grain/Best_Model.pth` |
|
| 33 |
+
| EBC | 3-class segmentation | 3 | `checkpoints/EBC/Best_Model.pth` |
|
| 34 |
+
| Super | 3-class segmentation | 3 | `checkpoints/Super/Best_Model.pth` |
|
| 35 |
+
| MetalDAM | 5-class segmentation | 5 | `checkpoints/MetalDAM/Best_Model.pth` |
|
| 36 |
+
| UHCS | 7-class segmentation | 7 | `checkpoints/UHCS/Best_Model.pth` |
|
| 37 |
+
|
| 38 |
+
Binary checkpoints produce one foreground logit; background is represented by
|
| 39 |
+
the complementary binary label. Multiclass counts include background.
|
| 40 |
+
|
| 41 |
+
## Training Details
|
| 42 |
+
|
| 43 |
+
- Input size: 512 x 512
|
| 44 |
+
- Batch size: 32
|
| 45 |
+
- Epochs: 500
|
| 46 |
+
- Optimizer: AdamW
|
| 47 |
+
- Learning rate: 0.0003
|
| 48 |
+
- Weight decay: 0.001
|
| 49 |
+
- Scheduler: CosineAnnealingLR with minimum learning rate 0.000001
|
| 50 |
+
- Early-stopping patience: 50
|
| 51 |
+
- Binary objective: Dice and BCEWithLogits
|
| 52 |
+
- Multiclass objective: Dice and cross-entropy
|
| 53 |
+
|
| 54 |
+
## Usage
|
| 55 |
+
|
| 56 |
+
Download a checkpoint and run the matching test entry point from the source
|
| 57 |
+
repository. Example for binary EMPS segmentation:
|
| 58 |
+
|
| 59 |
+
```bash
|
| 60 |
+
hf download NAMESPACE/microstructure-unet checkpoints/EMPS/Best_Model.pth --local-dir weights/unet
|
| 61 |
+
python CNN/U-net/predict.py \
|
| 62 |
+
--dataset-root /path/to/EMPS \
|
| 63 |
+
--checkpoint weights/unet/checkpoints/EMPS/Best_Model.pth \
|
| 64 |
+
--output-dir results/unet_emps
|
| 65 |
+
```
|
| 66 |
+
|
| 67 |
+
For EBC, Super, MetalDAM, and UHCS, use `CNN/U-net/test_mutil.py` and pass the
|
| 68 |
+
matching `--num-classes` value from the table.
|
| 69 |
+
|
| 70 |
+
## Evaluation
|
| 71 |
+
|
| 72 |
+
The public evaluation scripts restore predictions to the original resolution,
|
| 73 |
+
save raw masks, and calculate mIoU, Dice, precision, recall, accuracy, HD95,
|
| 74 |
+
Hausdorff distance, NSD, MAE, MBSS, and MBSS_add using `Myutils/metrics.py`.
|
| 75 |
+
Numerical benchmark results will be linked after the associated paper becomes
|
| 76 |
+
publicly available.
|
| 77 |
+
|
| 78 |
+
## Intended Use and Limitations
|
| 79 |
+
|
| 80 |
+
These checkpoints are intended for research reproduction and comparative
|
| 81 |
+
evaluation on the named microstructure datasets. They are dataset-specific and
|
| 82 |
+
should not be treated as general-purpose materials segmentation models. Image
|
| 83 |
+
acquisition conditions, magnification, annotation conventions, and unseen
|
| 84 |
+
microstructures may cause substantial performance degradation. They are not
|
| 85 |
+
validated for safety-critical or industrial quality-control decisions.
|
| 86 |
+
|
| 87 |
+
## License and Citation
|
| 88 |
+
|
| 89 |
+
The released experiment files are provided under the MIT license. The model
|
| 90 |
+
implementation and ImageNet initialization also remain subject to their
|
| 91 |
+
upstream terms. A paper citation will be added after publication.
|
checkpoint_manifest.json
ADDED
|
@@ -0,0 +1,77 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"model": "U-Net",
|
| 3 |
+
"source_code": "https://github.com/WUT-AI-AI4Mat/microstructure-segmentation-benchmark",
|
| 4 |
+
"checkpoint_count": 7,
|
| 5 |
+
"checkpoints": [
|
| 6 |
+
{
|
| 7 |
+
"dataset": "Aachen-Heerlen",
|
| 8 |
+
"task": "binary_segmentation",
|
| 9 |
+
"num_classes": 2,
|
| 10 |
+
"fine_tuning_route": "full_model",
|
| 11 |
+
"path": "checkpoints/Aachen-Heerlen/Best_Model.pth",
|
| 12 |
+
"size_bytes": 130438093,
|
| 13 |
+
"sha256": "70f3d25e937de33b3aa7480df248f148f515179738051d623d9918ccf338c985",
|
| 14 |
+
"requires_base_checkpoint": "none"
|
| 15 |
+
},
|
| 16 |
+
{
|
| 17 |
+
"dataset": "EBC",
|
| 18 |
+
"task": "multiclass_semantic_segmentation",
|
| 19 |
+
"num_classes": 3,
|
| 20 |
+
"fine_tuning_route": "full_model",
|
| 21 |
+
"path": "checkpoints/EBC/Best_Model.pth",
|
| 22 |
+
"size_bytes": 130439245,
|
| 23 |
+
"sha256": "08fdd67970562adf9184486d56f7c1ed1abd6a17ac964b5297e29ee7dcdc3c3c",
|
| 24 |
+
"requires_base_checkpoint": "none"
|
| 25 |
+
},
|
| 26 |
+
{
|
| 27 |
+
"dataset": "EMPS",
|
| 28 |
+
"task": "binary_segmentation",
|
| 29 |
+
"num_classes": 2,
|
| 30 |
+
"fine_tuning_route": "full_model",
|
| 31 |
+
"path": "checkpoints/EMPS/Best_Model.pth",
|
| 32 |
+
"size_bytes": 130438093,
|
| 33 |
+
"sha256": "f53ce3d927ba10d5d898efd6aa9f78d7a85351057c824e3b4471addaa9e08008",
|
| 34 |
+
"requires_base_checkpoint": "none"
|
| 35 |
+
},
|
| 36 |
+
{
|
| 37 |
+
"dataset": "Grain",
|
| 38 |
+
"task": "binary_segmentation",
|
| 39 |
+
"num_classes": 2,
|
| 40 |
+
"fine_tuning_route": "full_model",
|
| 41 |
+
"path": "checkpoints/Grain/Best_Model.pth",
|
| 42 |
+
"size_bytes": 130438093,
|
| 43 |
+
"sha256": "1e8848fc872b36ef9d7c093477a5a92ada47dfb0e468da85e090ce1b36063fd1",
|
| 44 |
+
"requires_base_checkpoint": "none"
|
| 45 |
+
},
|
| 46 |
+
{
|
| 47 |
+
"dataset": "MetalDAM",
|
| 48 |
+
"task": "multiclass_semantic_segmentation",
|
| 49 |
+
"num_classes": 5,
|
| 50 |
+
"fine_tuning_route": "full_model",
|
| 51 |
+
"path": "checkpoints/MetalDAM/Best_Model.pth",
|
| 52 |
+
"size_bytes": 130440397,
|
| 53 |
+
"sha256": "f957f80232f02aa0a0b615db37412aadf0909ef959fb1defc8a0a351e33c3778",
|
| 54 |
+
"requires_base_checkpoint": "none"
|
| 55 |
+
},
|
| 56 |
+
{
|
| 57 |
+
"dataset": "Super",
|
| 58 |
+
"task": "multiclass_semantic_segmentation",
|
| 59 |
+
"num_classes": 3,
|
| 60 |
+
"fine_tuning_route": "full_model",
|
| 61 |
+
"path": "checkpoints/Super/Best_Model.pth",
|
| 62 |
+
"size_bytes": 130439245,
|
| 63 |
+
"sha256": "2e2800754c8045b361bf9b7c7c690aa83b5817315a225eaafe5f63e30a36490e",
|
| 64 |
+
"requires_base_checkpoint": "none"
|
| 65 |
+
},
|
| 66 |
+
{
|
| 67 |
+
"dataset": "UHCS",
|
| 68 |
+
"task": "multiclass_semantic_segmentation",
|
| 69 |
+
"num_classes": 7,
|
| 70 |
+
"fine_tuning_route": "full_model",
|
| 71 |
+
"path": "checkpoints/UHCS/Best_Model.pth",
|
| 72 |
+
"size_bytes": 130441549,
|
| 73 |
+
"sha256": "ce4392bba3bd6653311b2b925684bbb0758f7aa73336ebd78aa13b30370aa18d",
|
| 74 |
+
"requires_base_checkpoint": "none"
|
| 75 |
+
}
|
| 76 |
+
]
|
| 77 |
+
}
|
checkpoints/Aachen-Heerlen/Best_Model.pth
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:70f3d25e937de33b3aa7480df248f148f515179738051d623d9918ccf338c985
|
| 3 |
+
size 130438093
|
checkpoints/EBC/Best_Model.pth
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:08fdd67970562adf9184486d56f7c1ed1abd6a17ac964b5297e29ee7dcdc3c3c
|
| 3 |
+
size 130439245
|
checkpoints/EMPS/Best_Model.pth
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:f53ce3d927ba10d5d898efd6aa9f78d7a85351057c824e3b4471addaa9e08008
|
| 3 |
+
size 130438093
|
checkpoints/Grain/Best_Model.pth
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:1e8848fc872b36ef9d7c093477a5a92ada47dfb0e468da85e090ce1b36063fd1
|
| 3 |
+
size 130438093
|
checkpoints/MetalDAM/Best_Model.pth
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:f957f80232f02aa0a0b615db37412aadf0909ef959fb1defc8a0a351e33c3778
|
| 3 |
+
size 130440397
|
checkpoints/Super/Best_Model.pth
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:2e2800754c8045b361bf9b7c7c690aa83b5817315a225eaafe5f63e30a36490e
|
| 3 |
+
size 130439245
|
checkpoints/UHCS/Best_Model.pth
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:ce4392bba3bd6653311b2b925684bbb0758f7aa73336ebd78aa13b30370aa18d
|
| 3 |
+
size 130441549
|