CSPadPixCoords/include/PixCoordsQuad.h

Go to the documentation of this file.

#ifndef CSPADPIXCOORDS_PIXCOORDSQUAD_H
#define CSPADPIXCOORDS_PIXCOORDSQUAD_H

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

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

//----------------------
// Base Class Headers --
//----------------------

//-------------------------------
// Collaborating Class Headers --
//-------------------------------
#include "CSPadPixCoords/PixCoords2x1.h"
#include "PSCalib/CSPadCalibPars.h"

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

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

namespace CSPadPixCoords {

/// @addtogroup CSPadPixCoords

/**
 *  @ingroup CSPadPixCoords
 *
 *  @brief PixCoordsQuad class defines the quad pixel coordinates in its local frame.
 *
 *  Use the same frame like in optical measurement, but in "matrix style" geometry:
 *  X axis goes along rows (from top to bottom)
 *  Y axis goes along columns (from left to right)
 *
 *  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: PixCoordsQuad.h 8040 2014-04-19 01:00:36Z dubrovin@SLAC.STANFORD.EDU $
 *
 *  @author Mikhail S. Dubrovin
 */

class PixCoordsQuad  {
public:

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

  // Default constructor
  /**
   *  @brief PixCoordsQuad class fills and provides access to the quad 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_2x1  Pointer to the object with 2x1 section 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
   */
  PixCoordsQuad ( PixCoords2x1 *pix_coords_2x1,  PSCalib::CSPadCalibPars *cspad_calibpar, bool tiltIsApplied = true ) ;

  // Destructor
  virtual ~PixCoordsQuad () ;

  void fillAllQuads();
  void fillOneQuad               (uint32_t quad);
  void fillOneSectionInQuad      (uint32_t quad, uint32_t sect, double xcenter, double ycenter, double zcenter, double rotation);
  void fillOneSectionTiltedInQuad(uint32_t quad, uint32_t sect, double xcenter, double ycenter, double zcenter, double rotation, double tilt);
  void setConstXYMinMax();

  /**
   *  Access methods return the coordinate for indicated axis, quad, section, row, and column
   *  indexes after the quad rotation by n*90 degree.
   *  The pixel coordinates can be returned in um(micrometers) and pix(pixels).
   */
  double getPixCoorRot000_um (CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoorRot090_um (CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoorRot180_um (CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoorRot270_um (CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;

  double getPixCoorRot000_pix(CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoorRot090_pix(CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoorRot180_pix(CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoorRot270_pix(CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;

  double getPixCoorRotN90_um (CSPadPixCoords::PixCoords2x1::ORIENTATION orient, 
                             CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoorRotN90_pix(CSPadPixCoords::PixCoords2x1::ORIENTATION orient, 
                             CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;
  double getPixCoorRotN90    (CSPadPixCoords::PixCoords2x1::UNITS units,
                             CSPadPixCoords::PixCoords2x1::ORIENTATION orient, 
                             CSPadPixCoords::PixCoords2x1::COORDINATE icoor, unsigned quad, unsigned sect, unsigned row, unsigned col) ;

protected:

private:

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

  double m_degToRad; 

  PixCoords2x1            *m_pix_coords_2x1;  
  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_min[NQuadsInCSPad];
  double m_coor_x_max[NQuadsInCSPad];
  double m_coor_y_min[NQuadsInCSPad];
  double m_coor_y_max[NQuadsInCSPad];

  // Copy constructor and assignment are disabled by default
  PixCoordsQuad ( const PixCoordsQuad& ) ;
  PixCoordsQuad& operator = ( const PixCoordsQuad& ) ;

};

} // namespace CSPadPixCoords

#endif // CSPADPIXCOORDS_PIXCOORDSQUAD_H

---