WUT-AI-AI4Mat commited on
Commit
143a91f
·
verified ·
1 Parent(s): ce3597b

Upload model card and dataset checkpoints

Browse files
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