ATS-GPU-OCT Programmer’s guide

Note

This is the documentation for AlazarTech’s ATS-GPU version 23.1.1. Please visit our documentation homepage to find documentation for other versions or products.

License Agreement

Copyright (c) 2008-2023 Alazar Technologies, Inc.

Important

CAREFULLY READ THIS SOFTWARE LICENSE AGREEMENT. BY CLICKING THE APPLICABLE BUTTON TO COMPLETE THE INSTALLATION PROCESS, YOU AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT. IF YOU DO NOT WISH TO BECOME A PARTY TO THIS AGREEMENT AND BE BOUND BY ITS TERMS AND CONDITIONS, DO NOT INSTALL OR USE THE SOFTWARE, AND RETURN THE SOFTWARE (WITH ANY ACCOMPANYING MEDIA) WITHIN THIRTY (30) DAYS OF RECEIPT. ALL RETURNS TO ALAZAR TECHNOLOGIES INC. (“ALAZARTECH”) WILL BE SUBJECT TO ALAZARTECH’S THEN-CURRENT POLICY. IF YOU ARE ACCEPTING THESE TERMS ON BEHALF OF AN ENTITY, YOU AGREE THAT YOU HAVE AUTHORITY TO BIND THE ENTITY TO THESE TERMS.

Ownership

AlazarTech retains the ownership of ATS-GPU software (“Software”). It is licensed to you for use under the following conditions:

Grant of License

You may only concurrently use the Software on the computers that have an AlazarTech waveform digitizer card plugged in (for example, if you have purchased one AlazarTech card, you have a license for one concurrent usage). If the number of users of the Software exceeds the number of AlazarTech cards you have purchased, you must have a reasonable process in place to assure that the number of persons concurrently using the Software does not exceed the number of AlazarTech cards purchased.

This license is non-transferable.

Restrictions

You may not copy the documentation or Software except as described in the installation section of the Software manual. You may not distribute, rent, sub-lease or lease the Software or documentation, including translating or decomposing. You may not modify, reverse-engineer, decompile, or disassemble any part of the Software or documentation, or produce any derivative work other than software applications that communicate with AlazarTech hardware using the published Application Programming Interface (API).

You may not remove, block, or modify any titles, logos, trademarks, copyright and/or patent notices, digital watermarks, disclaimers, or other legal notices that are included in the Software.

Termination

This license and your right to use this Software automatically terminates if you fail to comply with any provision of this license agreement.

Rights

AlazarTech retains all rights not expressly granted. Nothing in this agreement constitutes a waiver of AlazarTech’s rights under the Canadian and U.S. copyright laws or any other Federal or State law.

Limited Warranty

Although AlazarTech has tested the Software and reviewed the documentation, ALAZARTECH MAKES NO WARRANTY OF REPRESENTATION, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO THIS SOFTWARE OR DOCUMENTATION, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. AS A RESULT, THIS SOFTWARE AND DOCUMENTATION IS LICENSED “as is” AND YOU, THE LICENSEE, ARE ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND PERFORMANCE. IN NO EVENT WILL ALAZARTECH BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THIS SOFTWARE OR DOCUMENTATION, even if advised of the possibility of such damages. In particular, AlazarTech shall have no liability for any data acquired, stored or processed with this Software, including the costs of recovering such data.

THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL OTHERS, ORAL OR WRITTEN, EXPRESSED OR IMPLIED. No AlazarTech dealer, agent or employee is authorized to make any modifications or additions to this warranty.

Information in this document is subject to change without notice and does not represent a commitment on the part of AlazarTech. The Software described in this document is furnished under this license agreement. The Software may be used or copied only in accordance with the terms of the agreement.

Some jurisdictions do not allow the exclusion of implied warranties or liability for incidental or consequential damages, so the above limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may also have other rights, which vary from jurisdiction to jurisdiction.

Introduction

ATS-GPU-OCT provides a framework to allow real-time OCT data processing from AlazarTech PCIe digitizers on a CUDA compatible GPU.

ATS-GPU-OCT internally calls ATS-CUDA-OCT, which is a low-level library that performs all the necessary operations to perform the Fourier Transform. ATS-CUDA-OCT is described in later in this guide in the section ATS-CUDA-OCT.

This document assumes that the reader is familiar with ATS-SDK, the standard interface for programming AlazarTech digitizers. Having a copy of the ATS-SDK manual available can be helpful, since many references to ATSApi functions are done here. The latest version of the ATS-SDK manual can be downloaded free of charge from AlazarTech’s website.

Prerequisites

System requirements

This software requires a PC with a CUDA-enabled GPU, and sufficient CPU resources to supply data to the GPU at the desired data acquisition rate. It also requires a working installation of the same version of ATS-GPU-BASE. It was tested with GeForce GTX Titan X (Maxwell), GeForce GTX980 and Quadro P5000. DDR4 memory and a modern chipset (X99, X299) will greatly improve transfer speed and overall performance.

Supported operating systems

Windows and Linux operating systems are supported. Please verify that your Linux distribution is supported by NVIDIA which supplies the CUDA toolkit required to use ATS-GPU.

Compiler support

CMake is required to build C/C++ code. CMake files are provided. On Linux, a C++11 compiler is required to build the library. On older Red Hat distributions, a devtoolset can be obtained to use a more recent version of gcc that supports C++11. NVCC is required to compile the example code, this compiler is included with CUDA toolkit.

CUDA driver requirements

In order to use ATS-GPU, you must install the appropriate driver for your CUDA-enabled GPU. Drivers can be downloaded at https://www.nvidia.com/Download/index.aspx.

Note

Under Windows operating systems, dynamic link libraries releated to ATS-GPU-OCT are installed by default in %WINDIR%System32. For applications to link approripately to them, %WINDIR%System32 must be added to the Windows PATH Environment Variable.

ATS-GPU-OCT

ATS-GPU-OCT leverages ATS-GPU-BASE to transfer data from an ATS PCIe digitizer to a GPU in a highly efficient manner. It then takes care of doing OCT processing on the data before sending it back to the host computer’s RAM.

Usage

ATS-GPU-OCT acquisitions are very similar to standard ATSApi acquisitions. Only the differences are listed here for brevity.

The central function of the ATS-GPU-OCT interface is ATS_GPU_OCT_Setup(). This function calls its ATS-GPU-BASE counterpart ATS_GPU_Setup() internally, which in turns calls AlazarBeforeAsyncRead(). It takes a few extra parameters:

  • OCTFlags: Used to define which data type, such as amplitude and phase, to obtain from the acquisition.

  • FFTLength: This is used to select the length of the Fourier transform done on the GPU. This value must be a power of two, and it also must be equal to or larger than the record length.

rc = ATS_GPU_OCT_Setup(
         boardHandle, channelMask, -(int) preTriggerSamples,
         samplesPerRecordPerChannel, recordsPerBuffer,
         buffersPerAcquisition * recordsPerBuffer, autoDMAFlags,
         OCTOptions, FFTLength, NULL, &fftBytesPerBuffer);

We then choose the window function applied to the acquired data before the FFT processing phase. The most common usage pattern is to first generate a window function using ATS_GPU_OCT_GenerateWindowFunction(), then to download it to the board using ATS_GPU_OCT_SetWindowFunction(). It is possible however to use entirely custom window functions instead of the ones generated by the API. It is also possible to use complex window functions by way of downloading two arrays of points: the first for the real part of the window and the other for the imaginary one.

rc = ATS_GPU_OCT_GenerateWindowFunction(
            FFT_WINDOW_HANNING, &window[0],
            samplesPerRecordPerChannel);
// Error handling

rc = ATS_GPU_OCT_SetWindowFunction(
            boardHandle, samplesPerRecordPerChannel,
            &window[0], NULL);
// Error handling

We then allocate memory on the GPU and CPU for data to be transferred to, and we post those buffers to the board. For this purpose, we use ATS_GPU_OCT_AllocBuffer(). This function allocates buffers on the GPU, and sets up all the intermediary state necessary for ATS-GPU-OCT to successfully transfer data. It also allocates data on the CPU to receive the processed OCT data.

for (int i = 0; i < numberOfBuffers; i++)
{
    buffers[i] = (float*) ATS_GPU_OCT_AllocBuffer(
        boardHandle, bytesPerResultBuffer, NULL);

    rc = ATS_GPU_OCT_PostBuffer(
        boardHandle, buffers[i], bytesPerResultBuffer);
    // Error handling
}

We can then start the acquisition with ATS_GP_OCT_StartCapture(). Once acquisition is started, ATS_GPU_OCT_GetBuffer() must be called as often as possible to retrieve a buffer containing processed data on the CPU. The data can then be used by the calling application. When no longer needed, the buffer needs to be posted back.

for (size_t i; i < buffers_per_acquisition; i++)
{
    rc = ATS_GPU_OCT_GetBuffer(
        boardHandle, buffers[bufferIndex],timeout_ms);
    // Error handling

    // TODO: Process sample data in this buffer.

    rc = ATS_GPU_OCT_PostBuffer(
        boardHandle, buffers[bufferIndex], bytesPerResultBuffer);
    // Error handling
}

When acquisition is complete, ATS_GPU_OCT_AbortCapture() must be called. Buffers allocated with ATS_GPU_OCT_AllocBuffer() should then be freed with ATS_GPU_OCT_FreeBuffer().

ATS_GPU_OCT_AbortCapture(boardHandle);

if (gpuFile != NULL)
    fclose(gpuFile);

// Free buffers
for (int i = 0; i < numberOfBuffers; i++) {
    ATS_GPU_OCT_FreeBuffer(boardHandle, buffers[i]);
}

LabVIEW Programming

LabVIEW applications must use the managed interface which allows the API to allocate and manage a list of buffers available to be filled by the board. These applications should call ATS_GPU_OCT_Setup() with the AMDA_ALLOC_BUFFERS option selected in the “autoDMAFlags” parameter. This option will cause the API to allocate and manage a list of buffers available to be filled by the board. It is therefore not necessary for the application to call ATS_GPU_OCT_AllocBuffer() or ATS_GPU_OCT_FreeBuffer(). The application must call ATS_GPU_OCT_ManageGetBuffer() to wait for a buffer to be filled. When the board receives sufficient trigger events to fill a buffer, the API will copy the data from the internal buffer to the user-supplied buffer. ATS_GPU_OCT_ManageGetBuffer() internally calls ATS_GPU_OCT_GetBuffer() and ATS_GPU_OCT_PostBuffer() so applcation should not use these API calls when using the managed interface.

LabVIEW users might find it convenient to edit the VI search paths to locate the appropriate subVIs for the different ATS-GPU packages and ATS-SDK. The VI Search Path can be set in the “Tools” menu under “Options”, in the “Path” category. Then select the “VI Search Path” from the drop down list. By unselecting “Use default” custom VI search paths can be added.

API Reference

Note

Errors from ATS-GPU-OCT will be logged in ATS_GPU.log. Relevant information about the error will be logged here and can be useful for debugging. For Windows users log file is located in %TEMP%. For Linux users log file is located in /tmp/.

enum ATS_GPU_OCT_OPTIONS

Types of data output that are generated by the acquisition. This is used in ATS_GPU_OCT_Setup()

Values:

enumerator ATS_GPU_OCT_LOG_OUTPUT
enumerator ATS_GPU_OCT_AMPLITUDE_OUTPUT
enumerator ATS_GPU_OCT_PHASE_OUTPUT
enumerator ATS_GPU_OCT_REAL_OUTPUT
enumerator ATS_GPU_OCT_IMAG_OUTPUT
enumerator ATS_GPU_OCT_SQRT_OUTPUT
enumerator ATS_GPU_OCT_RAWDATA_OUTPUT
enum ATS_GPU_OCT_WINDOWS

Window functions that can be generated by ATS_GPU_OCT_GenerateWindowFunction()

Values:

enumerator FFT_WINDOW_NONE
enumerator FFT_WINDOW_HANNING
enumerator FFT_WINDOW_HAMMING
enumerator FFT_WINDOW_BLACKMAN
enumerator FFT_WINDOW_BLACKMAN_HARRIS
enumerator FFT_WINDOW_BARTLETT
enumerator NUM_FFT_WINDOW_ITEMS

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_AbortCapture” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_AbortCapture (HANDLE boardHandle) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_AbortCapture (HANDLE boardHandle) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_AbortCapture (HANDLE boardHandle) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_AllocBuffer” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API void * ATS_GPU_OCT_AllocBuffer (HANDLE boardHandle, U32 bytesPerBuffer, void *reserved) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected identifier in nested name, got keyword: void [error at 20] ATS_GPU_OCT_API void * ATS_GPU_OCT_AllocBuffer (HANDLE boardHandle, U32 bytesPerBuffer, void *reserved) ——————–^ If declarator-id: Invalid C++ declaration: Expected identifier in nested name, got keyword: void [error at 20] ATS_GPU_OCT_API void * ATS_GPU_OCT_AllocBuffer (HANDLE boardHandle, U32 bytesPerBuffer, void *reserved) ——————–^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_EnableVerificationMode” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_EnableVerificationMode (BOOL enable, U32 boardType) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_EnableVerificationMode (BOOL enable, U32 boardType) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_EnableVerificationMode (BOOL enable, U32 boardType) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_FreeBuffer” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_FreeBuffer (HANDLE boardHandle, void *buffer) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_FreeBuffer (HANDLE boardHandle, void *buffer) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_FreeBuffer (HANDLE boardHandle, void *buffer) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_GenerateWindowFunction” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_GenerateWindowFunction (U32 windowType, float *window, U32 windowLength_samples) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_GenerateWindowFunction (U32 windowType, float *window, U32 windowLength_samples) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_GenerateWindowFunction (U32 windowType, float *window, U32 windowLength_samples) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_GetBuffer” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_GetBuffer (HANDLE boardHandle, void *buffer, U32 timeout_ms) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_GetBuffer (HANDLE boardHandle, void *buffer, U32 timeout_ms) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_GetBuffer (HANDLE boardHandle, void *buffer, U32 timeout_ms) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_GetVersion” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_GetVersion (U8 *major, U8 *minor, U8 *revision) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_GetVersion (U8 *major, U8 *minor, U8 *revision) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_GetVersion (U8 *major, U8 *minor, U8 *revision) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_ManageGetBuffer” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_ManageGetBuffer (HANDLE boardHandle, void *buffer, U32 bytesToCopy, U32 timeout_ms) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_ManageGetBuffer (HANDLE boardHandle, void *buffer, U32 bytesToCopy, U32 timeout_ms) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_ManageGetBuffer (HANDLE boardHandle, void *buffer, U32 bytesToCopy, U32 timeout_ms) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_PostBuffer” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_PostBuffer (HANDLE boardHandle, void *buffer, U32 bytesPerBuffer) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_PostBuffer (HANDLE boardHandle, void *buffer, U32 bytesPerBuffer) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_PostBuffer (HANDLE boardHandle, void *buffer, U32 bytesPerBuffer) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_SetBuffer” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_SetBuffer (void *dataInputBuffer, void *CPUResultBuffer, U32 samplesPerBuffer) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_SetBuffer (void *dataInputBuffer, void *CPUResultBuffer, U32 samplesPerBuffer) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_SetBuffer (void *dataInputBuffer, void *CPUResultBuffer, U32 samplesPerBuffer) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_SetWindowFunction” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_SetWindowFunction (HANDLE boardHandle, U32 samplesPerRecord, float *realWindowArray, float *imagWindowArray) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_SetWindowFunction (HANDLE boardHandle, U32 samplesPerRecord, float *realWindowArray, float *imagWindowArray) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_SetWindowFunction (HANDLE boardHandle, U32 samplesPerRecord, float *realWindowArray, float *imagWindowArray) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_Setup” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_Setup (HANDLE boardHandle, U32 channelSelect, long transferOffset, U32 samplesPerFFT, U32 FFTsPerBuffer, U32 FFTsPerAcquisition, U32 autoDMAFlags, U32 OCTFlags, U32 FFTLength, void *reserved, U32 *bytesPerResultBuffer) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_Setup (HANDLE boardHandle, U32 channelSelect, long transferOffset, U32 samplesPerFFT, U32 FFTsPerBuffer, U32 FFTsPerAcquisition, U32 autoDMAFlags, U32 OCTFlags, U32 FFTLength, void *reserved, U32 *bytesPerResultBuffer) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_Setup (HANDLE boardHandle, U32 channelSelect, long transferOffset, U32 samplesPerFFT, U32 FFTsPerBuffer, U32 FFTsPerAcquisition, U32 autoDMAFlags, U32 OCTFlags, U32 FFTLength, void *reserved, U32 *bytesPerResultBuffer) —————————-^

Warning

doxygenfunction: Unable to resolve function “ATS_GPU_OCT_StartCapture” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 16] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_StartCapture (HANDLE boardHandle) —————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_StartCapture (HANDLE boardHandle) —————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 28] ATS_GPU_OCT_API RETURN_CODE ATS_GPU_OCT_StartCapture (HANDLE boardHandle) —————————-^

ATS-CUDA-OCT

ATS-CUDA-OCT provides a framework to allow OCT data processing on a CUDA-enabled GPU. ATS-CUDA-OCT should be used with ATS-CUDA for buffer and stream manipulation. ATS-CUDA-OCT requires an AlazarTech board on the system in order to be used.

API Reference

Note

Errors from ATS-CUDA-OCT will be logged in ATS_GPU.log. Relevant information about the error will be logged here and can be useful for debugging. For Windows users log file is located in %TEMP%. For Linux users log file is located in /tmp/.

Warning

doxygenfunction: Unable to resolve function “ATS_CUDA_OCT_CreateFFTPlan” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 17] ATS_CUDA_OCT_API cudaFFTPlan * ATS_CUDA_OCT_CreateFFTPlan (U32 FFTLength, U32 recordsPerBuffer, U32 channelCount, cudaStream_t stream) —————–^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 29] ATS_CUDA_OCT_API cudaFFTPlan * ATS_CUDA_OCT_CreateFFTPlan (U32 FFTLength, U32 recordsPerBuffer, U32 channelCount, cudaStream_t stream) —————————–^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 29] ATS_CUDA_OCT_API cudaFFTPlan * ATS_CUDA_OCT_CreateFFTPlan (U32 FFTLength, U32 recordsPerBuffer, U32 channelCount, cudaStream_t stream) —————————–^

Warning

doxygenfunction: Unable to resolve function “ATS_CUDA_OCT_DestroyFFTPlan” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 17] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_DestroyFFTPlan (cudaFFTPlan *FFTPlan) —————–^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_DestroyFFTPlan (cudaFFTPlan *FFTPlan) —————————–^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_DestroyFFTPlan (cudaFFTPlan *FFTPlan) —————————–^

Warning

doxygenfunction: Unable to resolve function “ATS_CUDA_OCT_GenerateGPUWindowFunction” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 17] ATS_CUDA_OCT_API void * ATS_CUDA_OCT_GenerateGPUWindowFunction (U32 samplesPerRecordPerChannel, float *realWindowArray, float *imagWindowArray) —————–^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected identifier in nested name, got keyword: void [error at 21] ATS_CUDA_OCT_API void * ATS_CUDA_OCT_GenerateGPUWindowFunction (U32 samplesPerRecordPerChannel, float *realWindowArray, float *imagWindowArray) ———————^ If declarator-id: Invalid C++ declaration: Expected identifier in nested name, got keyword: void [error at 21] ATS_CUDA_OCT_API void * ATS_CUDA_OCT_GenerateGPUWindowFunction (U32 samplesPerRecordPerChannel, float *realWindowArray, float *imagWindowArray) ———————^

Warning

doxygenfunction: Unable to resolve function “ATS_CUDA_OCT_FFT” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 17] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_FFT (cudaFFTPlan *FFTPlan, void *GPUFFTIn, void *GPUFFTOut) —————–^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_FFT (cudaFFTPlan *FFTPlan, void *GPUFFTIn, void *GPUFFTOut) —————————–^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_FFT (cudaFFTPlan *FFTPlan, void *GPUFFTIn, void *GPUFFTOut) —————————–^

Warning

doxygenfunction: Unable to resolve function “ATS_CUDA_OCT_GetVersion” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 17] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_GetVersion (U8 *major, U8 *minor, U8 *revision) —————–^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_GetVersion (U8 *major, U8 *minor, U8 *revision) —————————–^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_GetVersion (U8 *major, U8 *minor, U8 *revision) —————————–^

Warning

doxygenfunction: Unable to resolve function “ATS_CUDA_OCT_PostFFT” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 17] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_PostFFT (void *GPUFFTOutput, void *GPUResultBuffer, cudaStream_t stream, U32 FFTLength, U32 recordsPerBuffer, U32 channelCount, U32 OCTFlags) —————–^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_PostFFT (void *GPUFFTOutput, void *GPUResultBuffer, cudaStream_t stream, U32 FFTLength, U32 recordsPerBuffer, U32 channelCount, U32 OCTFlags) —————————–^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_PostFFT (void *GPUFFTOutput, void *GPUResultBuffer, cudaStream_t stream, U32 FFTLength, U32 recordsPerBuffer, U32 channelCount, U32 OCTFlags) —————————–^

Warning

doxygenfunction: Unable to resolve function “ATS_CUDA_OCT_PreFFT” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 17] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_PreFFT (void *GPUBuffer, void *GPUFFTIn, cudaStream_t stream, void *GPUWindow, U32 samplesPerRecordPerChannel, U32 FFTLength, U32 recordsPerBuffer, U32 channelCount, U32 inputDataType) —————–^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_PreFFT (void *GPUBuffer, void *GPUFFTIn, cudaStream_t stream, void *GPUWindow, U32 samplesPerRecordPerChannel, U32 FFTLength, U32 recordsPerBuffer, U32 channelCount, U32 inputDataType) —————————–^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 29] ATS_CUDA_OCT_API RETURN_CODE ATS_CUDA_OCT_PreFFT (void *GPUBuffer, void *GPUFFTIn, cudaStream_t stream, void *GPUWindow, U32 samplesPerRecordPerChannel, U32 FFTLength, U32 recordsPerBuffer, U32 channelCount, U32 inputDataType) —————————–^

ATS-CUDA-PSOCT

ATS-CUDA-PSOCT is an add-on library to ATS-GPU-OCT that allows to output the signals of interest in polarization sensitive OCT. Using ATS-CUDA-PSOCT requires a seperate license.

API Reference

enum ATS_GPU_PSOCT_OPTIONS

Types of data output that are generated by the acquisition. This is used in ATS_GPU_OCT_Setup() or ATS_GPU_NUFFT_Setup()

Values:

enumerator ATS_GPU_PSOCT_REFLECTIVITY_OUTPUT
enumerator ATS_GPU_PSOCT_LOG_OUTPUT
enumerator ATS_GPU_PSOCT_RETARDATION_OUTPUT
enumerator ATS_GPU_PSOCT_AXIS_ORIENTATION_OUTPUT

Warning

doxygenfunction: Unable to resolve function “ATS_CUDA_PSOCT_PostFFT” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 19] ATS_CUDA_PSOCT_API RETURN_CODE ATS_CUDA_PSOCT_PostFFT (void *GPUVerticalFFTOutput, void *GPUHoriozontalFFTOutput, void *GPUResultBuffer, cudaStream_t stream, U32 FFTLength, U32 recordsPerBuffer, U32 OCTFlags) ——————-^ If the function has a return type: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 31] ATS_CUDA_PSOCT_API RETURN_CODE ATS_CUDA_PSOCT_PostFFT (void *GPUVerticalFFTOutput, void *GPUHoriozontalFFTOutput, void *GPUResultBuffer, cudaStream_t stream, U32 FFTLength, U32 recordsPerBuffer, U32 OCTFlags) ——————————-^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 31] ATS_CUDA_PSOCT_API RETURN_CODE ATS_CUDA_PSOCT_PostFFT (void *GPUVerticalFFTOutput, void *GPUHoriozontalFFTOutput, void *GPUResultBuffer, cudaStream_t stream, U32 FFTLength, U32 recordsPerBuffer, U32 OCTFlags) ——————————-^