stokescamera
Real-time stokes polarimetry using a polarisation camera and MATLAB (for now...)
Science Score: 52.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
✓Institutional organization owner
Organization witsoclab has institutional domain (www.wits.ac.za) -
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.8%) to scientific vocabulary
Repository
Real-time stokes polarimetry using a polarisation camera and MATLAB (for now...)
Basic Info
- Host: GitHub
- Owner: WitsOCLab
- License: mit
- Language: MATLAB
- Default Branch: main
- Size: 20.5 KB
Statistics
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
Real-time Stokes Polarimetry using a Polarisation Camera
Creator
Mitchell A. Cox
School of Electrical and Information Engineering, University of the Witwatersrand, Johannesburg, South Africa
Email: mitchell.cox@wits.ac.za
Homepage: https://www.wits.ac.za/oclab
Journal Paper
If you use this work, please cite our journal paper (which contains many details):
https://opg.optica.org/ao/abstract.cfm?uri=ao-62-29-7828
@article{cox2023stokes, title={Real-time Stokes polarimetry using a polarization camera}, author={Cox, Mitchell A and Rosales-Guzm{\'a}n, Carmelo}, journal={Applied Optics}, volume={62}, number={29}, pages={7828--7836}, year={2023}, publisher={Optica Publishing Group} }
Abstract
This lab note introduces the "Stokes Camera," a simple and novel experimental arrangement for real-time measurement of spatial amplitude and polarisation, leading to spatially resolved Stokes parameters. This setup uses a polarisation sensitive camera combined with a fixed quarter-wave plate. This offers a one-shot, digital solution for polarisation measurement that mainly depends on the camera's frame rate and the computation speed of the associated code. Moreover, this document provides background information on relevant polarisation theory and vector vortex beams, employed as an exemplification of the device's capabilities.
Table of Contents
Getting Started
Some instructions and details are provided in the associated journal paper (citation TBD).
- Create a video object using the MATLAB Image Acquisition Toolbox. Make note of the important line of code, which is something like v = videoinput("gige", 1, "Mono12Packed");
- While you have a preview window open (with the toolbox, or call preview(v); after creating the video object), make sure the two halves of the beam are visible on the camera.
- Simply call CameraPreviewStokes(v);
Note: The first run will take a few minutes while the code finds the overlap between the halves of the beam. Don't change the alignment from the beamsplitter onwards after this point.
Please feel free the check out the code. It's quite straight forward. There are additional options to use, such as a moving average of a number of frames. This helps with alignment with a moving beam (such as in turbulence).
If you make enhancements, changes, etc. that will benefit the community, please fork this repository, commit your changes to your own repo and then send us a pull request!
Creating "Stokes Plots"
Please see the file StokesPlot.m. When viewing the CameraPreviewStokes, hit 'p' on your keyboard and it will dump a timestamped .mat file with the various polaristion and stokes matrices. These can be input and plot as you desire.
License
This project is licensed under the MIT License. For more details, see the LICENSE file.
Acknowledgements
Thanks to Cade Ribiero from the Wits Structured Light Lab for initial testing and feedback.
Owner
- Name: Wits OC Lab
- Login: WitsOCLab
- Kind: organization
- Location: University of the Witwatersrand, Johannesburg, South Africa
- Website: https://www.wits.ac.za/oclab
- Repositories: 8
- Profile: https://github.com/WitsOCLab
Citation (CITATION.cff)
cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: Cox
given-names: Mitchell A.
orcid: https://orcid.org/0000-0002-1115-3729
- family-names: Rosales-Guzm\'an
given-names: Carmelo
title: "Real-time stokes polarimetry using a polarisation camera"
version: 1.0
doi: TBD
date-released: 2023-08-25
url: "https://github.com/WitsOCLab/StokesCamera"
GitHub Events
Total
- Member event: 1
Last Year
- Member event: 1