Examples
========

There are many example scripts on
`GitHub <https://github.com/LCAV/LenslessPiCam/tree/main/scripts>`__,
but they may not be the most intuitive way to get started with the library.
The following notebooks aim to provide a more interactive and intuitive
way to explore different functionalities of the library.

LenslessPiCam General Overview
------------------------------

The notebook below provides a general overview of the library (downloading/using datasets, PSF analysis/design, image recovery):

- `Overview <https://colab.research.google.com/drive/1q56Ht647JD5wocnrcT7rH5TCNK7FKmtH?usp=sharing>`__

A local version of the notebook can be found on `GitHub <https://github.com/LCAV/LenslessPiCam/blob/main/notebook/lenslesspicam_demo.ipynb>`__.
`Here <https://docs.google.com/presentation/d/1PcNhMfjATSwcpbHUMrmc88ciQmheBJ7alz8hel8xnGU/edit?pli=1#slide=id.p>`__
are accompanying slides that were given during a PhD course to introduce computational lensless imaging.

System / Hardware
-----------------

Using a programmable mask based lensless imaging system,
where the programmable is a low-cost LCD:

- `DigiCam: Single-Shot Lensless Sensing with a Low-Cost Programmable Mask <https://colab.research.google.com/drive/1t59uyZMMyCUYVHGXdqdlNlDlb--FL_3P#scrollTo=t9o50zTf3oUg>`__
- `Towards Scalable and Secure Lensless Imaging with a Programmable Mask <https://colab.research.google.com/drive/1YGfs9p4T4NefX8GemVWwtrw4aX8zH1qu#scrollTo=tipedTe4vGwD>`__

Reconstruction
---------------------

Learning-based reconstruction methods:

- `A Modular and Robust Physics-Based Approach for Lensless Image Reconstruction <https://colab.research.google.com/drive/1Wgt6ZMRZVuctLHaXxk7PEyPaBaUPvU33>`__
- `Aligning images for training & background subtraction demo <https://drive.google.com/file/d/1oWy07xT_5-_Xki6g9TbOiBcxDv0bN-96/view?usp=drive_link>`__
- `Aligning images for training (DigiCam) <https://colab.research.google.com/drive/1c6kUbiB5JO1vro0-IMd-YDDP1g7NFXv3#scrollTo=MtN7GWCIrBKr>`__

Mask Design and Fabrication
---------------------------

- `Multi-lens array design <https://drive.google.com/file/d/1IIGjdPUD5qqq4kWjDp50OWnIvHPVdvmp/view?usp=sharing>`__
- `Creating STEP files for 3D printing masks <https://colab.research.google.com/drive/1eDLnDL5q4i41xPZLn73wKcKpZksfkkIo?usp=sharing>`__