Update README.md
Browse files
README.md
CHANGED
@@ -1,3 +1,49 @@
|
|
1 |
-
|
2 |
-
|
3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# EMcopilot: Your label-free copilot for automated electron microscopy image analysis
|
2 |
+
|
3 |
+
|
4 |
+
## Training and Code Details
|
5 |
+
|
6 |
+
For detailed training procedures and source code, please refer to our GitHub repository:
|
7 |
+
[EMcopilot GitHub Repository](https://github.com/WenhaoYuan337/EMcopilot)
|
8 |
+
|
9 |
+
|
10 |
+
|
11 |
+
## Usage
|
12 |
+
|
13 |
+
1. **Train and predict segmentation models**:
|
14 |
+
* `00_01_sam_binary_masking.py` - Generates coarse masks using the SAM model.
|
15 |
+
3. **Generate and analyze synthetic masks**:
|
16 |
+
* `02_01_sam_mask_analysis.py` - Analyzes SAM mask properties and extracts morphology prior.
|
17 |
+
* `02_02_random_mask_generate.py` - Generates synthetic masks by augmenting existing masks.
|
18 |
+
5. **Generate and evaluate images**:
|
19 |
+
* `03_01_p2p_train.py` - Trains a Pix2Pix model for mask-to-EMimage translation.
|
20 |
+
* `04_01_pix2pix_predict.py` - Runs inference using the trained Pix2Pix model.
|
21 |
+
6. **Domain Adaptation**:
|
22 |
+
* `05_01_domain_adaptation.py` - Applies domain adaptation, including noise and contrast augmentation.
|
23 |
+
7. **UNet++ Training and Inference**:
|
24 |
+
* `06_01_unet++_train.py` - Trains a CBAM-enhanced UNet++ model for segmentation.
|
25 |
+
* `07_01_unet++_predict.py` - Performs inference using the trained UNet++ model.
|
26 |
+
8. **Analyze DM4 microscopy data**:
|
27 |
+
* `08_01_in_situ_analysis.py` - Analyze HAADF-STEM images of supported nanoparticles in real time.
|
28 |
+
|
29 |
+
## Installation
|
30 |
+
|
31 |
+
Install required packages using:
|
32 |
+
```bash
|
33 |
+
pip install -r requirements.txt
|
34 |
+
```
|
35 |
+
## Citation
|
36 |
+
If you find our code or data useful in your research, please cite our paper:
|
37 |
+
```
|
38 |
+
@misc{yuan2024deepgenerativemodelsassistedautomated,
|
39 |
+
title={Deep Generative Models-Assisted Automated Labeling for Electron Microscopy Images Segmentation},
|
40 |
+
author={Wenhao Yuan and Bingqing Yao and Shengdong Tan and Fengqi You and Qian He},
|
41 |
+
year={2024},
|
42 |
+
eprint={2407.19544},
|
43 |
+
archivePrefix={arXiv},
|
44 |
+
primaryClass={cond-mat.mtrl-sci},
|
45 |
+
url={https://arxiv.org/abs/2407.19544},
|
46 |
+
}
|
47 |
+
```
|
48 |
+
Copyright | 2025 Qian's Lab@NUS
|
49 |
+
|