CSPadPixCoords/include/PixCoordsCSPad.h

Go to the documentation of this file.

#ifndef CSPADPIXCOORDS_PIXCOORDSCSPAD_H
#define CSPADPIXCOORDS_PIXCOORDSCSPAD_H

//--------------------------------------------------------------------------
// File and Version Information:
//      $Id: PixCoordsCSPad.h 8040 2014-04-19 01:00:36Z dubrovin@SLAC.STANFORD.EDU $
//
// Description:
//      Class PixCoordsCSPad.
//
//------------------------------------------------------------------------

//-----------------
// C/C++ Headers --
//-----------------

//----------------------
// Base Class Headers --
//----------------------
#include "CSPadPixCoords/PixCoordsQuad.h"
#include "PSCalib/CSPadCalibPars.h"

//-------------------------------
// Collaborating Class Headers --
//-------------------------------

//------------------------------------
// Collaborating Class Declarations --
//------------------------------------

//              ---------------------
//              -- Class Interface --
//              ---------------------

namespace CSPadPixCoords {

/// @addtogroup CSPadPixCoords

/**
 *  @ingroup CSPadPixCoords
 *
 *  @brief PixCoordsCSPad class fills and provides access to the CSPad pixel coordinates.
 *  
 *  Fills/holds/provides access to the arrays of the CSPad pixel coordinates, 
 *  using the quad, section, row, and column indexes.
 *
 *  This software was developed for the LCLS project.  If you use all or 
 *  part of it, please give an appropriate acknowledgment.
 *
 *  @see CSPadImageProducer, PixCoordsTest
 *
 *  @version $Id: PixCoordsCSPad.h 8040 2014-04-19 01:00:36Z dubrovin@SLAC.STANFORD.EDU $
 *
 *  @author Mikhail S. Dubrovin
 */


class PixCoordsCSPad  {
public:

  enum { NQuadsInCSPad = 4 };
  enum { N2x1InQuad    = 8 };
  enum { NCols2x1      = Psana::CsPad::ColumnsPerASIC     }; // 185
  enum { NRows2x1      = Psana::CsPad::MaxRowsPerASIC * 2 }; // 194*2 = 388

  /**
   *  @brief PixCoordsCSPad class fills and provides access to the CSPad pixel coordinates.
   *  
   *  Fills/holds/provides access to the array of the quad coordinates, indexed by the quad, section, row, and column.
   *  @param[in] pix_coords_quad  Pointer to the object with quad pixel coordinates.
   *  @param[in] cspad_calibpar   Pointer to the object with geometry calibration parameters.
   *  @param[in] tiltIsApplied    Boolean key indicating if the tilt angle correction for 2x1 and Quads is applied
   */
  PixCoordsCSPad ( PixCoordsQuad *pix_coords_quad,  PSCalib::CSPadCalibPars *cspad_calibpar, bool tiltIsApplied = true ) ;

  /// Destructor
  virtual ~PixCoordsCSPad () ;

  void fillAllQuadCoordsInCSPad() ;
  void fillOneQuadCoordsInCSPad(uint32_t quad) ;
  void fillOneQuadTiltedCoordsInCSPad(uint32_t quad) ;
  void setConstXYMinMax() ;
  void fillArrsOfCSPadPixCoords() ;

  /// Fill CSPAD pixel coordinate array using center_global type of constants from class PixCoordsCSPadV2
  void fillArrsOfCSPadPixCoordsFromCenterGlobal() ;

  /**
   *  @brief Access methods return the CSPad pixel coordinate for indicated axis, quad, section, row, and column indexes.
   *  The pixel coordinates can be returned in um(micrometers), pix(pixels), or int(integer pixel index).
   */
  double getPixCoor_um (CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoor_pix(CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoor_int(CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;

  /**
   *  @brief The group of methods which provide the direct access to coordinate arrays.
   */
  double*   getPixCoorArrX_um (){return &m_coor_x    [0][0][0][0];}
  double*   getPixCoorArrY_um (){return &m_coor_y    [0][0][0][0];}
  double*   getPixCoorArrX_pix(){return &m_coor_x_pix[0][0][0][0];}
  double*   getPixCoorArrY_pix(){return &m_coor_y_pix[0][0][0][0];}
  uint32_t* getPixCoorArrX_int(){return &m_coor_x_int[0][0][0][0];}
  uint32_t* getPixCoorArrY_int(){return &m_coor_y_int[0][0][0][0];}

private:

  // Data members
  CSPadPixCoords::PixCoords2x1::COORDINATE XCOOR;
  CSPadPixCoords::PixCoords2x1::COORDINATE YCOOR;
  CSPadPixCoords::PixCoords2x1::COORDINATE ZCOOR;

  double m_degToRad; 

  PixCoordsQuad           *m_pix_coords_quad;  
  PSCalib::CSPadCalibPars *m_cspad_calibpar;  
  bool                     m_tiltIsApplied;

  double   m_coor_x    [NQuadsInCSPad][N2x1InQuad][NCols2x1][NRows2x1];
  double   m_coor_y    [NQuadsInCSPad][N2x1InQuad][NCols2x1][NRows2x1];
  double   m_coor_x_pix[NQuadsInCSPad][N2x1InQuad][NCols2x1][NRows2x1];
  double   m_coor_y_pix[NQuadsInCSPad][N2x1InQuad][NCols2x1][NRows2x1];
  uint32_t m_coor_x_int[NQuadsInCSPad][N2x1InQuad][NCols2x1][NRows2x1];
  uint32_t m_coor_y_int[NQuadsInCSPad][N2x1InQuad][NCols2x1][NRows2x1];

  double   m_xmin_quad [NQuadsInCSPad]; 
  double   m_ymin_quad [NQuadsInCSPad]; 

  double m_coor_x_min;
  double m_coor_y_min;
  double m_coor_x_max;
  double m_coor_y_max;

  /// Copy constructor is disabled by default
  PixCoordsCSPad ( const PixCoordsCSPad& ) ;
  /// Assignment constructor is disabled by default
  PixCoordsCSPad& operator = ( const PixCoordsCSPad& ) ;

  enum { NX_CSPAD = 1750,   // Image sizes are used to get constant m_coor_y_max and m_coor_y_max 
         NY_CSPAD = 1750 }; // In this class we do not need in these image sizes...
};

} // namespace CSPadPixCoords

#endif // CSPADPIXCOORDS_PIXCOORDSCSPAD_H

---