vDataFile.hh

Go to the documentation of this file.

#ifndef VDATAFILE_HH
#define VDATAFILE_HH 1

#include "gVariables.hh"
#include "vEvent.hh"
#include "iEventPET.hh"
#include "iEventListPET.hh"
#include "iEventHistoPET.hh"
#include "iEventSPECT.hh"
#include "iEventTransmission.hh"
#include "iEventNorm.hh"
#include "sOutputManager.hh"
#include "sScannerManager.hh"
#include "oImageDimensionsAndQuantification.hh"

#define MODE_UNKNOWN -1

#define MODE_LIST 0

#define MODE_HISTOGRAM 1

#define MODE_NORMALIZATION 2

#define TYPE_UNKNOWN -1

#define TYPE_PET 0

#define TYPE_SPECT 1

#define TYPE_TRANSMISSION 2

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

  // -------------------------------------------------------------------
  // Public member functions
  public:
    int ReadInfoInHeader(bool a_affectQuantificationFlag = true);
    int CheckParameters();
    int InitializeFile();
    virtual int ComputeSizeEvent() = 0;
    virtual int PrepareDataFile() = 0;
    void ResetBufferRange();
    int FillBuffer(int64_t a_eventIndex);
    vEvent* GetEventWithAscendingOrderAssumption(int64_t a_eventIndex, int64_t a_eventIndexLimit, int a_th);
    vEvent* GetEventWithoutOrderAssumption(int64_t a_eventIndex, int a_th);
    vEvent* GetEventFromFile(int64_t a_eventIndex, int a_th);
    virtual vEvent* GetEventFromBuffer(char* ap_buffer, int a_th) = 0;
    void GetEventIndexStartAndStop(int64_t* ap_indexStart, int64_t* ap_indexStop, int a_subsetNum = 0, int a_NbSubsets = 1);
    int CheckConsistencyWithAnotherBedDatafile(vDataFile* ap_Datafile);

  // -------------------------------------------------------------------
  // Functions dedicated to analytical projections
  public:
    virtual int PROJ_InitFile() = 0;
    virtual int PROJ_GetScannerSpecificParameters() = 0;
    virtual int PROJ_WriteEvent(vEvent* ap_Event, int a_th) = 0;
    

    virtual int PROJ_WriteHeader() = 0;




    int PROJ_WriteData();
    int PROJ_DeleteTmpDatafile();
    vEvent* PROJ_GenerateEvent(int idx_elt1, int idx_elt2, int a_th);

  // -------------------------------------------------------------------
  // Public Get & Set FUNCTIONS
  public:
    inline int GetBedIndex()
           {return m_bedIndex;}
    inline int GetDataMode()
           {return m_dataMode;}
    inline int GetDataType()
           {return m_dataType;}
    int64_t GetSize()
         {return m_totalNbEvents;}
    int64_t GetEventSize() {return m_sizeEvent;}
    inline string GetHeaderDataFileName()
           {return m_headerFileName;};
    inline string GetDataFileName()
           {return m_dataFileName;};
    inline int64_t GetStartTime()
           {return m_startTimeInSec;};
    inline int64_t GetDuration()
           {return m_durationInSec;};
    inline FLTNB GetCalibrationFactor()
           {return m_calibrationFactor;}
    inline FLTNB* GetPOIResolution()
           {return mp_POIResolution;}
    inline bool GetPOIInfoFlag()
           {return m_POIInfoFlag;}
    inline bool GetIgnorePOIFlag()
           {return m_ignorePOIFlag;}
    virtual int GetMaxRingDiff();
    inline void SetDataMode(int a_dataMode)
           {m_dataMode = a_dataMode;}
    inline void SetDataType(int a_dataType)
           {m_dataType = a_dataType;}
    inline void SetBedIndex(int a_bedIndex)
           {m_bedIndex = a_bedIndex;}
    inline void SetPercentageLoad(int a_percentageLoad)
           {m_percentageLoad = a_percentageLoad;}
    inline int GetPercentageLoad()
           {return m_percentageLoad;}
    inline void SetVerbose(int a_verboseLevel)
           {m_verbose = a_verboseLevel;}
    inline int GetVerbose()
           {return m_verbose;}
    inline void SetImageDimensionsAndQuantification(oImageDimensionsAndQuantification* ap_ImageDimensionsAndQuantification)
           {mp_ID = ap_ImageDimensionsAndQuantification;}
    inline void SetPOIResolution(FLTNB ap_value[3])
           {for (int i=0 ; i<3 ; i++) mp_POIResolution[i] = ap_value[i];} 
    inline void SetIgnorePOIFlag(bool a_ignorePOIFlag)
           {m_ignorePOIFlag = a_ignorePOIFlag;}
    inline void SetHeaderDataFileName(const string& a_headerFileName)
           {m_headerFileName = a_headerFileName;}
    inline void SetCalibrationFactor(FLTNB a_value)
           {m_calibrationFactor = a_value;} 
    inline void SetNbEvents(int64_t a_value)
           {m_totalNbEvents = a_value;} 
    inline void SetStartTime(FLTNB a_value)
           {m_startTimeInSec = a_value;} 
    inline void SetDuration(FLTNB a_value)
           {m_durationInSec = a_value;}
    inline string GetScannerName()
           {return m_scannerName;}

  // -------------------------------------------------------------------
  // Private member functions
  private:
    virtual int CheckSpecificParameters() = 0;
    virtual int CheckFileSizeConsistency() = 0;
    virtual int ReadSpecificInfoInHeader(bool a_affectQuantificationFlag = true) = 0;
    virtual int CheckSpecificConsistencyWithAnotherDatafile(vDataFile* ap_Datafile) = 0;
    
    virtual int Shuffle( int64_t );

    
  // -------------------------------------------------------------------
  // Data members
  protected:
    oImageDimensionsAndQuantification* mp_ID; 
    int m_verbose;                            
    // Variables related to the acquisition
    fstream** m2p_dataFile;                   
    string m_headerFileName;                  
    string m_dataFileName;                    
    int64_t m_totalNbEvents;                  
    int m_dataMode;                           
    int m_dataType;                           
    FLTNB m_startTimeInSec;                   
    FLTNB m_durationInSec;                    
    FLTNB m_calibrationFactor;                
    int m_bedIndex;                           
    int64_t m_sizeEvent;                      
    string m_scannerName;                     
    // POI: Position Of Interaction
    bool m_POIInfoFlag;                       
    bool m_ignorePOIFlag;                     
    bool mp_POIDirectionFlag[3];              
    FLTNB mp_POIResolution[3];                
    // Variable related to Buffer/Container arrays
    vEvent** m2p_BufferEvent;                 
    char* mp_arrayEvents;                     
    char** m2p_bufferEventFromFile;           
    int64_t m_mpi1stEvent;                    
    int64_t m_mpiLastEvent;                   
    int64_t m_mpiNbEvents;                    
    int64_t m_1stIdxArrayEvents;              
    int64_t m_lastIdxArrayEvents;             
    int64_t m_sizeArrayEvents;                
    int m_percentageLoad;                     
    bool m_requestBufferFilling;              
    bool m_currentlyFillingBuffer;            
    bool* mp_currentlyReadingBuffer;          
    bool* mp_overBufferRange;                
    int64_t* mp_nbEventsReadFromFile;         
};

#endif