Skip to content

Phase Extraction Extension is a plugin for OCTproZ. It can be used to determine a suitable resampling curve for k-linearization.

License

Notifications You must be signed in to change notification settings

spectralcode/octproz-phase-extraction-extension

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Phase Extraction Extension

Phase Extraction Extension is a plugin for OCTproZ. It can be used to determine a suitable resampling curve for k-linearization.

How it works

The phase of a calibration signal is extracted, which is used to generate a resampling curve for k-linearization.

A calibration signal can be easily generated by placing a glass window close to the OCT reference arm mirror.

A detailed explanation can be found in the publication.

How to use

Watch this video!

Demo dataset

A demo dataset can be found here.

Download and installation

Download the zip archive from the GitHub release section and extract it into the OCTproZ folder (phaseextractionextension.dll should be placed in the plugins folder and libfftw3-3.dll should be in the same folder as octproz.exe).

How to compile

Phase Extraction Extension is a submodule of OCTproZ and you can clone it together with OCTproZ.

1. Clone the Repository

Full OCTproZ with all submodules

Clone OCTproZ along with all its submodules, including the Phase Extraction Extension:

git clone --recurse-submodules https://github.com/spectralcode/OCTproZ.git

If you've already cloned OCTproZ without submodules:

cd OCTproZ
git submodule update --init --recursive

The Phase Extraction Extension will be located at:

OCTproZ/octproz_project/octproz_plugins/octproz-phase-extraction-extension

It is automatically included in the OCTproZ build via octproz_plugins.pro.

Clone Only the Phase Extraction Extension Submodule

If you already have OCTproZ cloned and just need the Phase Extraction Extension:

cd OCTproZ
git submodule update --init octproz_project/octproz_plugins/octproz-phase-extraction-extension

2. Install Dependencies

Windows

The OCTproZ build process will automatically copy the necessary FFTW3 DLLs (e.g., libfftw3-3.dll) to the folder where octproz.exe resides.

Ubuntu / Linux

Install FFTW3 via package manager:

sudo apt-get install libfftw3 libfftw3-dev

3. Compile with Qt Creator

  1. Open Qt Creator.
  2. Load the main project file: OCTproZ/octproz_project/octproz_project.pro
  3. Select the appropriate Qt kit if not already done.
  4. The Phase Extraction Extension will already be included in the build, as it's part of octproz_plugins.pro.
  5. Build the project.

There is also a video showing how to build the Phase Extraction Extension on Windows, available here. Note that the video is slightly outdated, as the Phase Extraction Extension was not a submodule at the time of recording. The relevant part starts at minute 12:50.

Dependencies

Publication

M. Zabic, S. Hansert, S. Johannsmeier, D. Heinemann, A. Heisterkamp, and T. Ripken, "OCT wavenumber calibration with simple reference arm modification," in European Conferences on Biomedical Optics 2021 (ECBO), OSA Technical Digest (Optical Society of America, 2021), paper EW4A.5.

License

Phase Extraction Extension is licensed under GPLv3. See LICENSE.

About

Phase Extraction Extension is a plugin for OCTproZ. It can be used to determine a suitable resampling curve for k-linearization.

Resources

License

Stars

Watchers

Forks

Packages

No packages published