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
Last synced: 10 months ago · JSON representation

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
Created almost 2 years ago · Last pushed over 1 year ago
Metadata Files
Readme

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

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

requirements.txt pypi
  • 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