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 |
+
|