https://github.com/complight/focal_surface_holographic_light_transport
https://github.com/complight/focal_surface_holographic_light_transport
Science Score: 36.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
○.zenodo.json file
-
✓DOI references
Found 2 DOI reference(s) in README -
✓Academic publication links
Links to: arxiv.org, scholar.google -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.2%) to scientific vocabulary
Repository
Basic Info
- Host: GitHub
- Owner: complight
- Language: Python
- Default Branch: main
- Size: 22.6 MB
Statistics
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
Focal Surface Holographic Light Transport using Learned Spatially Adaptive Convolutions
Chuanjun Zheng, Yicheng Zhan, Liang Shi, Ozan Cakmakci, Kaan Akşit

Project Site Arxiv Manuscript Supplementary
Getting started
(0) Requirments
Please make sure to have the right dependencies installed.
bash
pip3 install -r requirements.txt
Install the latest version of Odak.
bash
git clone git@github.com:kaanaksit/odak.git
cd odak
pip3 install -r requirements.txt
pip3 install -e .
(1) Testing
You can start testing using the following syntax:
(1.1) Default test
bash
git clone git@github.com:complight/focal_surface_holographic_light_transport.git
cd focal_surface_holographic_light_transport
python test.py
After running the script, you can find the output in the test_output directory. The primary result of the test will be the reconstructed image, which will be saved as reconstruction_image.png.
(1.2) Customizing the test
If you would like to test with a different focal surface file or change the output directory, you can specify these as arguments when running the script:
bash
python test.py --focal_surface_filename ./path/to/your/focal_surface.png --hologram_phase_filename ./path/to/your/hologram.png --output_directory ./path/to/output
(2) Training
(2.1) Preparing your dataset
We strongly encourage you to refer to the previous work of our group,
multicolor, to generate the
dataset based on your own settings. Alternatively, you can directly
use odak.learn.wave.multi_color_hologram_optimizer.
(2.2) Revising the settings
Please consult the settings file found in sample_zero.txt, where you will find a list of self descriptive variables that you can modify according to your needs.
This way, you can create a new settings file or modify the existing one.
(2.3) Starting training
shell
python main.py
Support
For more support regarding the code base, please use the issues section of this repository to raise issues and questions.
Citation
If you find our work useful in your research, please consider citing:
bibtex
@inproceedings{zheng2024focalholography,
title={Focal Surface Holographic Light Transport using Learned Spatially Adaptive Convolutions},
author={Chuanjun Zheng, Yicheng Zhan, Liang Shi, Ozan Cakmakci, and Kaan Ak{\c{s}}it},
booktitle = {SIGGRAPH Asia 2024 Technical Communications (SA Technical Communications '24)},
keywords = {Computer-Generated Holography, Light Transport, Optimization},
location = {Tokyo, Japan},
series = {SA '24},
month={December},
year={2024},
doi={https://doi.org/10.1145/3681758.3697989}
}
Owner
- Name: Computational Light Laboratory
- Login: complight
- Kind: organization
- Email: k.aksit@ucl.ac.uk
- Location: United Kingdom
- Website: https://complightlab.com
- Twitter: complightlab
- Repositories: 5
- Profile: https://github.com/complight
Research at the intersection of light, computation, graphics and perception.
GitHub Events
Total
- Watch event: 5
- Push event: 16
- Public event: 1
- Fork event: 1
Last Year
- Watch event: 5
- Push event: 16
- Public event: 1
- Fork event: 1
Dependencies
- Pillow ==9.4.0
- imageio ==2.30.0
- importlib-resources ==6.1.0
- lpips ==0.1.4
- matplotlib ==3.7.1
- numpy ==1.24.4
- odak ==0.2.6
- opencv-python ==4.7.0.72
- plotly ==5.18.0
- plyfile ==1.0.1
- protobuf ==3.20.3
- python-dateutil ==3.8.0
- scikit-image ==0.21.0
- scipy ==1.10.1
- threadpoolctl ==3.5.0
- tifffile ==2023.7.10
- timm ==0.9.12
- torch ==2.0.1
- torchvision ==0.15.2
- tqdm ==4.66.1