CSPadPixCoords::PixCoords2x1V2 Class Reference
[CSPadPixCoords package]

PixCoords2x1V2 class defines the 2x1 sensor pixel coordinates in its local frame. V2 stands for latest version. More...

#include <PixCoords2x1V2.h>

Inheritance diagram for CSPadPixCoords::PixCoords2x1V2:


Public Types
	AXIS_X = 0
	AXIS_Y
	AXIS_Z
	UM = 0
	PIX
enum	AXIS { AXIS_X = 0, AXIS_Y, AXIS_Z }
	Enumerator for X, Y, and Z axes. More...
enum	UNITS { UM = 0, PIX }
	Enumerator for scales, coordinates in micrometers or pixels. More...
Public Member Functions
	PixCoords2x1V2 (bool use_wide_pix_center=false)
	Fills-in the map of perfect 2x1 coordinates, defined through the chip geometry.
virtual	~PixCoords2x1V2 ()
	Destructor.
void	print_coord_arrs_2x1 ()
	Prints 2x1 pixel coordinates.
void	print_member_data ()
	Prints class member data.
void	print_map_min_max (UNITS units, const double &angle_deg)
	Prints minimal and maximal values of the 2x1 coordinate map.
double *	get_x_map_2x1_um ()
	Returns pointer to the 2x1 pixel map of x-coordinate [um].
double *	get_y_map_2x1_um ()
	Returns pointer to the 2x1 pixel map of y-coordinate [um].
double *	get_z_map_2x1_um ()
	Returns pointer to the 2x1 pixel map of z-coordinate [um].
double *	get_x_map_2x1_pix ()
	Returns pointer to the 2x1 pixel map of x-coordinate [pix].
double *	get_y_map_2x1_pix ()
	Returns pointer to the 2x1 pixel map of y-coordinate [pix].
double *	get_z_map_2x1_pix ()
	Returns pointer to the 2x1 pixel map of z-coordinate [pix].
const unsigned	get_size ()
	Returns sizee of the coordinate arrays.
double *	get_coord_map_2x1 (AXIS axis, UNITS units, const double &angle_deg=0)
	Returns pointer to the 2x1 pixel map for specified parameters.
double	get_min_of_coord_map_2x1 (AXIS axis, UNITS units, const double &angle_deg=0)
	Returns minimal value of the 2x1 pixel coordinate for specified parameters.
double	get_max_of_coord_map_2x1 (AXIS axis, UNITS units, const double &angle_deg=0)
	Returns miximal value of the 2x1 pixel coordinate for specified parameters.
Static Public Attributes
static const unsigned	ROWS2X1 = 185
	Number of pixel rows in 2x1.
static const unsigned	COLS2X1 = 388
	Number of pixel columnss in 2x1.
static const unsigned	COLS2X1HALF = 194
	Half number of pixel columnss in 2x1.
static const unsigned	SIZE2X1 = COLS2X1*ROWS2X1
	Number of pixels in 2x1.
static const unsigned	NCORNERS = 4
	Number of corners...
static const double	PIX_SIZE_COLS = 109.92
	Pixel size [um] in column direction.
static const double	PIX_SIZE_ROWS = 109.92
	Pixel size [um] in row direction.
static const double	PIX_SIZE_WIDE = 274.80
	Wide pixel length [um].
static const double	PIX_SIZE_UM = 109.92
	Pixel size [um].
static const double	UM_TO_PIX = 1./109.92
	Conversion factor between um and pix.
Protected Member Functions
void	make_maps_of_2x1_pix_coordinates ()
	Generator of the 2x1 pixel coordinate map.

Detailed Description

PixCoords2x1V2 class defines the 2x1 sensor pixel coordinates in its local frame. V2 stands for latest version.

2x1 sensor coordinate frame:

    (Xmin,Ymax)      ^ Y          (Xmax,Ymax)
    (0,0)            |            (0,387)
       ------------------------------
       |             |              |
       |             |              |
       |             |              |
     --|-------------+--------------|----> X
       |             |              |
       |             |              |
       |             |              |
       ------------------------------
    (184,0)          |           (184,387)
    (Xmin,Ymin)                  (Xmax,Ymin)

The (r,c)=(0,0) is in the top left corner of the matrix which has coordinates (Xmin,Ymax) Here we assume that 2x1 has 185 rows and 388 columns. This assumption differs from the DAQ map, where rows and cols are interchanged: /reg/g/psdm/sw/external/lusi-xtc/2.12.0a/x86_64-rhel5-gcc41-opt/pdsdata/cspad/ElementIterator.hh, Detector.hh

Interface Description

Include and typedef

  #include "CSPadPixCoords/PixCoords2x1V2.h"
  typedef CSPadPixCoords::PixCoords2x1V2 PC2X1;

Instatiation

       PC2X1 *pix_coords_2x1 = new PC2X1();  
  or
       bool use_wide_pix_center = true;
       PC2X1 *pix_coords_2x1 = new PC2X1(use_wide_pix_center);

Printing methods

       pix_coords_2x1 -> print_member_data();
       pix_coords_2x1 -> print_coord_arrs_2x1();

       double angle = 5;
       pix_coords_2x1 -> print_map_min_max(PC2X1::PIX);
       pix_coords_2x1 -> print_map_min_max(PC2X1::PIX, angle);
       pix_coords_2x1 -> print_map_min_max(PC2X1::UM);
       pix_coords_2x1 -> print_map_min_max(PC2X1::UM, angle);

Access methods

       double* x_arr = pix_coords_2x1 -> get_x_map_2x1_pix ();
       double* y_arr = pix_coords_2x1 -> get_y_map_2x1_pix ();
       double* z_arr = pix_coords_2x1 -> get_z_map_2x1_pix (); // returns 0-s
  or
       double* x_arr = pix_coords_2x1 -> get_coord_map_2x1 (PC2X1::AXIS_X, PC2X1::UM, angle);
       double* y_arr = pix_coords_2x1 -> get_coord_map_2x1 (PC2X1::AXIS_Y, PC2X1::UM, angle);
       double* z_arr = pix_coords_2x1 -> get_coord_map_2x1 (PC2X1::AXIS_Z, PC2X1::UM, angle); // returns 0-s

       double x_min_um  = pix_coords_2x1 -> get_min_of_coord_map_2x1 (PC2X1::AXIS_X, PC2X1::UM,  angle);
       double y_min_um  = pix_coords_2x1 -> get_min_of_coord_map_2x1 (PC2X1::AXIS_Y, PC2X1::UM,  angle);
       double z_min_um  = pix_coords_2x1 -> get_min_of_coord_map_2x1 (PC2X1::AXIS_Z, PC2X1::UM,  angle);
       double y_max_pix = pix_coords_2x1 -> get_max_of_coord_map_2x1 (PC2X1::AXIS_Y, PC2X1::PIX, angle);

This software was developed for the LCLS project. If you use all or part of it, please give an appropriate acknowledgment.

Version:: $Id: PixCoords2x1V2.h 8646 2014-07-16 00:09:51Z dubrovin@SLAC.STANFORD.EDU $

Author:: Mikhail S. Dubrovin

Definition at line 159 of file PixCoords2x1V2.h.

Member Enumeration Documentation

enum CSPadPixCoords::PixCoords2x1V2::AXIS

Enumerator for X, Y, and Z axes.

Enumerator:

AXIS_X
AXIS_Y
AXIS_Z

Definition at line 163 of file PixCoords2x1V2.h.

enum CSPadPixCoords::PixCoords2x1V2::UNITS

Enumerator for scales, coordinates in micrometers or pixels.

Enumerator:

UM
PIX

Definition at line 168 of file PixCoords2x1V2.h.

Constructor & Destructor Documentation

CSPadPixCoords::PixCoords2x1V2::PixCoords2x1V2 ( bool use_wide_pix_center = false )

Fills-in the map of perfect 2x1 coordinates, defined through the chip geometry.

Parameters:

[in] use_wide_pix_center Optional parameter can be used if the wide-pixel row coordinate is prefered to be in the raw center.

Definition at line 89 of file PixCoords2x1V2.cpp.

References make_maps_of_2x1_pix_coordinates().

CSPadPixCoords::PixCoords2x1V2::~PixCoords2x1V2 ( ) [virtual]

Destructor.

Definition at line 103 of file PixCoords2x1V2.cpp.

Member Function Documentation

double * CSPadPixCoords::PixCoords2x1V2::get_coord_map_2x1	(	AXIS	axis,
		UNITS	units,
		const double &	angle_deg = `0`
	)

Returns pointer to the 2x1 pixel map for specified parameters.

Parameters:

`[in]`	axis	Axis from the enumerated list for X, Y, and Z
`[in]`	units	Units [UM] or [PIX] from the enumerated list
`[in]`	angle_deg	2x1 rotation angle [degree]