vScanner.hh

Go to the documentation of this file.

#ifndef VSCANNER_HH
#define VSCANNER_HH 1

#include "gVariables.hh"
#include "sOutputManager.hh"
#include "oMatrix.hh"
#include "sRandomNumberGenerator.hh"





#define GEO_ROT_CW 0

#define GEO_ROT_CCW 1

class sScannerManager;


class vScanner
{
  // -------------------------------------------------------------------
  // Constructor & Destructor
  public:
    vScanner();
    virtual ~vScanner();


  // -------------------------------------------------------------------
  // Public member functions
  public:
    virtual int Instantiate(bool a_scannerFileIsLUT) = 0;
    virtual int BuildLUT(bool a_scannerFileIsLUT) = 0;
    virtual int CheckParameters() = 0;
    virtual int Initialize() = 0;
    virtual int GetPositionsAndOrientations( int a_index1, int a_index2,
                                             FLTNB ap_Position1[3], FLTNB ap_Position2[3],
                                             FLTNB ap_Orientation1[3], FLTNB ap_Orientation2[3],
                                             FLTNB* ap_POI1 = NULL, FLTNB* ap_POI2 = NULL ) = 0;
    virtual int GetRdmPositionsAndOrientations( int a_index1, int a_index2,
                                                FLTNB ap_Position1[3], FLTNB ap_Position2[3],
                                                FLTNB ap_Orientation1[3], FLTNB ap_Orientation2[3] ) = 0;
    virtual int GetPositionWithRandomDepth( int a_index1, int a_index2, FLTNB ap_Position1[3], FLTNB ap_Position2[3] ) = 0;
    virtual int GetTwoCorners( int a_index1, int a_index2,
                               FLTNB ap_CornerInf1[3], FLTNB ap_CornerSup1[3],
                               FLTNB ap_CornerInf2[3], FLTNB ap_CornerSup2[3]) = 0;
    virtual int ComputeLUT();
    virtual int LoadLUT();
    virtual int GetSystemNbElts() = 0;
    virtual int IsAvailableLOR(int a_elt1, int a_elt2);
    virtual void ShowHelp() = 0;
    virtual int GetGeometricInfoFromDatafile(string a_path) = 0;
    inline int GetScannerType()
           {return m_scannerType;}
    inline void SetVerbose(int a_verboseLevel)
           {m_verbose = a_verboseLevel;}
    inline FLTNB GetMultiBedDisplacementInMm()
           {return m_multiBedDisplacementInMm;}


  // -------------------------------------------------------------------
  // PET dedicated functions (only overloaded by PET scanner class)
  public:
    virtual int SetPETMaxRingDiff(int a_maxRingDiff);
    virtual int GetScannerLayerNbRings(int a_layer);
  
    virtual int SetRotDirection( string a_rotDirection );

    virtual int PROJ_GetPETSpecificParameters(int* ap_maxRingDiff);


  // -------------------------------------------------------------------
  // SPECT dedicated functions (only surcharged by SPECT scanner classes)
  public:
    virtual int GetSPECTSpecificParameters( uint16_t* ap_nbOfProjections, 
                                            uint16_t* ap_nbHeads, 
                                            uint16_t* ap_nbOfBins,
                                            FLTNB*  ap_pixSizeXY, 
                                            FLTNB*& ap_angles, 
                                            FLTNB*& ap_CORtoDetectorDistance,
                                            int* ap_headRotDirection );
    virtual int PROJ_SetSPECTNbBins( uint16_t* ap_nbOfBins );
    virtual int PROJ_SetSPECTNbProjections( uint32_t a_nbOfProjections );
    virtual int PROJ_SetSPECTAngles( FLTNB* ap_projectionAngles );
    virtual int PROJ_SetSPECTCORtoDetectorDistance( FLTNB a_CORtoDetectorDistance );
    virtual uint16_t PROJ_GetSPECTNbProjections(); // required for analytic projection (computations of indices for projection main loops in sScannerManager)
    virtual uint16_t PROJ_GetSPECTNbPixels(); // required for analytic projection (computations of index for projection main loops in sScannerManager)
    
    
  // -------------------------------------------------------------------
  // Private member functions
  private:


  // -------------------------------------------------------------------
  // Data members
  protected:
    int m_scannerType;               
    int m_verbose;                   
    bool m_allParametersChecked;     
    oMatrix *mp_rotationMatrix;      
    oMatrix *mp_positionMatrix_ref;  
    oMatrix *mp_positionMatrix_out;  
    int m_rotDirection;              
    FLTNB m_multiBedDisplacementInMm; 
};


// ----------------------------------------------------------------------
// Part of code that manages the auto declaration of children classes
// ----------------------------------------------------------------------

// Macro for the function that creates the object
#define FUNCTION_SCANNER(CLASS) \
  static vScanner *make_scanner() { return new CLASS(); };

// Macro for the class that links the appropriate function to the map of objects
#define CLASS_SCANNER(NAME,CLASS)                                                             \
  class NAME##ScannerCreator                                                                  \
  {                                                                                           \
    public:                                                                                   \
      NAME##ScannerCreator()                                                                  \
        { sAddonManager::GetInstance()->mp_listOfScannerTypes[#NAME] = CLASS::make_scanner; } \
  };                                                                                          \
  static NAME##ScannerCreator ScannerCreator##NAME;

#endif