tdchbt.h

Go to the documentation of this file.

/******************************************************************************
 *
 *  Project:        TDC Control Library
 *
 *  Filename:       tdchbt.h
 *
 *  Purpose:        g(2) Functions and Fitting
 *
 *  Author:         NHands GmbH & Co KG
 */
/*****************************************************************************/
/*****************************************************************************/
/* $Id: tdchbt.h,v 1.4 2020/08/24 16:17:34 trurl Exp $ */

#ifndef __TDCHBT_H
#define __TDCHBT_H

#include "tdcdecl.h"

#define HBT_PARAM_SIZE  5

typedef enum {
  FCTTYPE_NONE,          
  FCTTYPE_COHERENT,      
  FCTTYPE_THERMAL,       
  FCTTYPE_SINGLE,        
  FCTTYPE_ANTIBUNCH,     
  FCTTYPE_THERM_JIT,     
  FCTTYPE_SINGLE_JIT,    
  FCTTYPE_ANTIB_JIT,     
  FCTTYPE_THERMAL_OFS,   
  FCTTYPE_SINGLE_OFS,    
  FCTTYPE_ANTIB_OFS,     
  FCTTYPE_THERM_JIT_OFS, 
  FCTTYPE_SINGLE_JIT_OFS,
  FCTTYPE_ANTIB_JIT_OFS  
} HBT_FctType;


typedef struct {
  Int32   capacity;     
  Int32   size;         
  Int32   binWidth;     
  Int32   indexOffset;  
  double  values[1];    
} TDC_HbtFunction;


TDC_API int TDC_CC TDC_enableHbt( Bln32 enable );


TDC_API int TDC_CC TDC_setHbtParams( Int32 binWidth,
                                     Int32 binCount );


TDC_API int TDC_CC TDC_getHbtParams( Int32 * binWidth,
                                     Int32 * binCount );


TDC_API int TDC_CC TDC_setHbtDetectorParams( double jitter );


TDC_API int TDC_CC TDC_getHbtDetectorParams( double * jitter );


TDC_API int TDC_CC TDC_setHbtInput( Int32 channel1,
                                    Int32 channel2 );


TDC_API int TDC_CC TDC_getHbtInput( Int32 * channel1,
                                    Int32 * channel2 );


TDC_API int TDC_CC TDC_resetHbtCorrelations();


TDC_API int TDC_CC TDC_getHbtEventCount( Int64  * totalCount,
                                         Int64  * lastCount,
                                         double * lastRate );


TDC_API int TDC_CC TDC_getHbtIntegrationTime( double * intTime );


TDC_API int TDC_CC TDC_getHbtCorrelations( Bln32             forward,
                                           TDC_HbtFunction * fct );


TDC_API int TDC_CC TDC_calcHbtG2( TDC_HbtFunction * fct );


TDC_API int TDC_CC TDC_fitHbtG2( const TDC_HbtFunction * fct,
                                 HBT_FctType    fitType,
                                 const double * startParams,
                                 double       * fitParams,
                                 Int32        * iterations );


TDC_API const double * TDC_CC TDC_getHbtFitStartParams( HBT_FctType fctType,
                                                        double *    params );


TDC_API int TDC_CC TDC_calcHbtModelFct( HBT_FctType       fctType,
                                        const double    * params,
                                        TDC_HbtFunction * fct );


TDC_API int TDC_CC TDC_generateHbtDemo( HBT_FctType    fctType,
                                        const double * params,
                                        double         noiseLv );


TDC_API TDC_HbtFunction * TDC_CC TDC_createHbtFunction( void );


TDC_API void TDC_CC TDC_releaseHbtFunction( TDC_HbtFunction * fct );


TDC_API void TDC_CC TDC_analyseHbtFunction( const TDC_HbtFunction * fct,
                                            Int32  * capacity,
                                            Int32  * size,
                                            Int32  * binWidth,
                                            Int32  * iOffset,
                                            double * values,
                                            Int32    bufSize );

#endif