A tool built for analysing skylight polarization patterns. It aims to provide heading information from skylight angle of polarization images.
This repository has been deprecated in favour of this project.
compyss is designed to be as flexible as possible. It's flexibility allows it to support multiple cameras and decode methods. Once you write a decoder, it should be available for all supported cameras. See the wiki for more information.
This package was written in conjuction with a study at Queen's University at Kingston. If you use this code, please cite our work. We have not published yet, but when we do I will link the citation here.
- Load LI image from camera or file.
- Generate Stokes vector, AoLP, and DoLP from LI image.
- Display image information in figure.
- Read angle to solar meridian from AoLP image.
- Lucid Vision Labs, Arena SDK
Examples are provided in the source. The general flow is
import compyss.core
from compyss.sources.file import FileSource
# create a new compass object
cmps = compyss.core.Compass(source=FileSource("path/to/file.png")
image = cmps.source.get().instrument_to_local()
image.show()
python -m pip install compyss
General dependencies are listed in the requirements.txt file and can be installed using python -m pip install -r requirements.txt
or something similar.
Camera sources require specific dependencies that do not apply globally. Using the available camera sources requires installing their interface. For example, LUCID Vision cameras require the ArenaSDK to be installed. See wiki for more info.
Currently, the project uses polanalyser to do some image processing.
For questions, open an issue or send an email to ben [dot] potter [at] queensu [dot] ca.
If you use this code, open a PR and add your project to this list. We also ask you cite our paper. See author.
Contributions are welcome, mostly with respect to camera SDK support. If you need support for another camera SDK, reach out to me ben [dot] potter [at] queensu [dot] ca.
- Create an ImageDecoder class that standardizes decoder format. Package user should create a decoder object and pass it to the compass object similar to the ImageSource class.
- Fix exposure settings in arena_sdk to improve execution time of that pipeline.
- Support saving features to LUCID cameras via arena_sdk.py