pado-optics 1.0.1

Pytorch Automatic Differentiable Optics

PADO

Pytorch Automatic Differentiable Optics

📚 Documentation• 🚀 Quickstart • ✨ Features • ⚙️ Installation • 📄 License

---

📋 Overview

🌊PADO (파도) is a cutting-edge framework for differentiable optical simulations powered by PyTorch. Inspired by the Korean word for "wave," PADO enables seamless and fully differentiable simulation workflows, perfect for researchers and developers in optical physics, computational imaging, and beyond.

---

✨ Features

• 🔥 Fully Differentiable: Integrates effortlessly with PyTorch Autograd.
• 🏎️ CUDA Acceleration: Leverages GPU hardware for ultra-fast simulations.
• 🧩 Modular Components: Easily customizable optical elements and simulation environments.
• 📊 Visualization Tools: Rich visualization with Matplotlib.
• ⚡ Easy-to-use API: Beginner-friendly API for rapid experimentation.

---

⚙️ Installation

You can install PADO via pip:

pip install pado-optics

Or via conda:

conda install -c conda-forge pado-optics

Or install directly from GitHub:

pip install git+https://github.com/shwbaek/pado.git

For development installation:

git clone https://github.com/shwbaek/pado.git
cd pado
pip install -e .

---

📚 Documentation

Comprehensive documentation is available at https://shwbaek.github.io/pado.

---

🚀 Quickstart

PADO includes a comprehensive set of example notebooks organized by topic:

Exploring Examples

Browse our examples by category:

• 1. Basics

  • 1.1 Pado fundamentals - Learn about core components and building blocks
  • 1.2 RGB multi-wavelength - Working with multiple wavelengths
  • 1.3 4-F with batch - Batch processing in 4-F systems
  • 1.4 How to use ASM options - Angular Spectrum Method configuration

• 2. Computer Generated Holography

  • 2.1 DPAC - Double Phase Amplitude Coding
  • 2.2 Multi-depth CGH - Multi-plane holography
  • 2.3 CGH optimization - GS, SGD, and Adam methods
  • 2.4 Multi-depth hologram with Adam - Complex loss-based optimization
  • 2.5 Phase-only SLM optimization - Optimization with phase-only spatial light modulators
  • 2.6 Multi-depth hologram with phase-only SLM - Multi-plane optimization with phase-only SLMs

• 3. Coded Imaging

  • 3.1 Lens comparison - Different lens models and wavefront observation
  • 3.2 Coded aperture comparison - Coded aperture techniques
  • 3.3 Seeing through DOE - Imaging through diffractive optical elements

• 4. Polarization Imaging

  • 4.1 Polarization light - Polarized light simulation

• 5. Advanced Applications

  • 5.1 Chromatic aberration singlet - Chromatic aberration simulation

---

ℹ️ About

Developed and maintained by the POSTECH Computer Graphics Lab.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

📝 Citation

If you use Pado in your research, please cite Pado using the following BibText template:

@misc{Pado,
   Author = {Seung-Hwan Baek, Dong-Ha Shin, Yujin Jeon, Seung-Woo Yoon, Eunsue Choi, Gawoon Ban, Hyunmo Kang},
   Year = {2025},
   Note = {https://github.com/shwbaek/pado},
   Title = {Pado: Pytorch Automatic Differentiable Optics}
}