File size: 3,410 Bytes
6af8cb3
ec6b668
7f5c4ef
6a013c7
7f5c4ef
6af8cb3
 
a5185bf
6af8cb3
 
7f5c4ef
 
a5185bf
 
 
 
 
6af8cb3
 
ec6b668
7f5c4ef
 
 
 
 
 
 
 
 
 
 
ec6b668
afc4432
 
7f5c4ef
 
 
ec6b668
7f5c4ef
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
ec6b668
7f5c4ef
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
a5185bf
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
---
title: WaveOrder
emoji: πŸ”¬
python_version: 3.13
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 6.0.2
app_file: app.py
pinned: false
license: bsd-3-clause
tags:
- microscopy
- computational-imaging
- phase-reconstruction
- bioimaging
- scientific-visualization
---

# WaveOrder

<div align="center">

[![arXiv](https://img.shields.io/badge/arXiv-2412.09775-b31b1b.svg)](https://arxiv.org/abs/2412.09775)
[![GitHub](https://img.shields.io/badge/GitHub-mehta--lab%2Fwaveorder-181717?logo=github)](https://github.com/mehta-lab/waveorder)
[![Paper Page](https://img.shields.io/badge/Paper%20Page-Hugging%20Face-ff9d00?logo=huggingface)](https://huggingface.co/papers/2412.09775)

</div>

## πŸ“„ Paper

**WaveOrder: generalist framework for label-agnostic computational microscopy**
Chandler T., Ivanov I.E., Hirata-Miyasaki E., et al. "WaveOrder: Physics-informed ML for auto-tuned multi-contrast computational microscopy from cells to
 organisms." [arXiv:2412.09775](https://arxiv.org/abs/2412.09775) (2025)

## πŸ”¬ About

Interactive web interface for exploring phase reconstruction from quantitative label-free microscopy data. This demo showcases the WaveOrder framework's capabilities for reconstructing phase contrast images with interactive parameter optimization.

### Features

- **Interactive Visualization**: Side-by-side comparison of raw and reconstructed phase images
- **Real-time Parameter Tuning**: Adjust reconstruction parameters and see results instantly
- **Automated Optimization**: Gradient-based optimization to find optimal reconstruction parameters
- **GPU Acceleration**: 15-25Γ— speedup with CUDA-capable devices (auto-detected)
- **Multi-FOV Support**: Navigate through multiple fields of view from plate imaging

### Reconstruction Parameters

- **Z Offset**: Axial focus calibration
- **Numerical Apertures**: Detection and illumination NA optimization
- **Tilt Angles**: Zenith and azimuthal illumination tilt correction

## πŸš€ Usage

1. **Select Field of View**: Choose from available FOVs in the dropdown
2. **Navigate Z-stack**: Use the Z-slice slider to explore different focal planes
3. **Optimize Parameters**: Click "⚑ Optimize Parameters" to automatically find optimal settings
4. **Manual Reconstruction**: Adjust sliders manually and click "πŸ”¬ Run Reconstruction"
5. **Review Results**: Scrub through optimization iterations to see parameter evolution

## πŸ“Š Dataset

This demo uses concatenated 20x objective microscopy data from high-content screening plates, featuring brightfield phase contrast imaging.

## πŸ”— Links

- **Paper**: [arXiv:2412.09775](https://arxiv.org/abs/2412.09775)
- **GitHub Repository**: [mehta-lab/waveorder](https://github.com/mehta-lab/waveorder)
- **Documentation**: [WaveOrder Docs](https://github.com/mehta-lab/waveorder/tree/main/docs)

## πŸ“ Citation

```bibtex
@misc{chandler2024waveordergeneralistframeworklabelagnostic,
      title={waveOrder: generalist framework for label-agnostic computational microscopy},
      author={Talon Chandler and Eduardo Hirata-Miyasaki and Ivan E. Ivanov and Ziwen Liu and Deepika Sundarraman and Allyson Quinn Ryan and Adrian Jacobo and Keir Balla and Shalin B. Mehta},
      year={2024},
      eprint={2412.09775},
      archivePrefix={arXiv},
      primaryClass={physics.optics},
      url={https://arxiv.org/abs/2412.09775},
}
```

## βš–οΈ License

BSD 3-Clause License