A generic regular pixel grid with dead space between cells. More...

#include <PndDiscSensorGrid.h>

Inheritance diagram for SensorGrid::BasicGrid:

Public Member Functions
	BasicGrid ()

	BasicGrid (const double &x_min, const double &x_width, const double &x_pitch, int n_x, const double &y_min, const double &y_width, const double &y_pitch, int n_y)

virtual	~BasicGrid ()

void	SetXDivision (const double &x_min, const double &x_width, const double &x_pitch, int n_x)

void	SetYDivision (const double &y_min, const double &y_width, const double &y_pitch, int n_y)

virtual bool	PositionToPixel (const double &x, const double &y, PixelInfo &pixel_info) const
	Convert a hit position to a pixel number. More...

virtual bool	PixelToPosition (PixelInfo &pixel_info, double &x, double &y) const
	Compute the center-position of a pixel on this grid and update the pixel_info structure. More...

virtual void	EnumerateGrids (int &id, int &pixel_offset)

void	SetUserColumnOffset (int ofs)

void	SetUserRowOffset (int ofs)

void	LockGrid (bool lock)
	Lock the grid: More...

bool	IsLocked ()

int	GetNumberOfPixels ()

virtual bool	NextPixel (double &x, double &y, PixelInfo &pixel_number) const
	Return information of the next pixel (pixel iteration) More...

Protected Member Functions
virtual void	LockChilds (bool)

void	SetPixelNumberOffset (int offset)

void	EnumerateGridsProxy (SensorGridBase *b, int &grid_id, int &pixel_number)

void	LockChildsProxy (SensorGridBase *b, bool lock)

Protected Attributes
double	x_min

double	x_width

double	x_pitch

double	x_width_over_two_pitch

double	y_min

double	y_width

double	y_pitch

double	y_width_over_two_pitch

int	n_x

int	n_y

double	x_max

double	y_max

int	grid_number

int	pixel_number_offset

int	user_row_offset
	The pixel number of the first pixel in this grid (or its childs) More...

int	user_col_offset
	user prowided offset to add to row on grid value in PixelInfo More...

int	number_of_pixels
	user prowided offset to add to column on grid value in PixelInfo More...

bool	locked
	The total number of pixels in this grid (or its childs) More...

Detailed Description

A generic regular pixel grid with dead space between cells.

Definition at line 83 of file PndDiscSensorGrid.h.

Constructor & Destructor Documentation

SensorGrid::BasicGrid::BasicGrid ( )

Definition at line 53 of file PndDiscSensorGrid.cxx.

53 { }

SensorGrid::BasicGrid::BasicGrid	(	const double &	x_min,
		const double &	x_width,
		const double &	x_pitch,
		int	n_x,
		const double &	y_min,
		const double &	y_width,
		const double &	y_pitch,
		int	n_y
	)

Todo:: : throw here

Definition at line 56 of file PndDiscSensorGrid.cxx.

References n_x, n_y, SensorGrid::SensorGridBase::number_of_pixels, x_max, x_min, x_pitch, x_width, x_width_over_two_pitch, y_max, y_min, y_pitch, y_width, and y_width_over_two_pitch.

     : SensorGridBase(), x_min(x_min_), x_width(x_width_), x_pitch(x_pitch_),
       y_min(y_min_), y_width(y_width_), y_pitch(y_pitch_), n_x(n_x_), n_y(n_y_)
 {
     x_width_over_two_pitch = x_width/(2.*x_pitch);
     y_width_over_two_pitch = y_width/(2.*y_pitch);
     x_max = x_min + double(n_x)*x_pitch;
     y_max = y_min + double(n_y)*y_pitch;
     number_of_pixels = n_x*n_y;
 }

SensorGrid::BasicGrid::~BasicGrid ( )

virtual

Definition at line 70 of file PndDiscSensorGrid.cxx.

70 { }

Member Function Documentation

void SensorGrid::BasicGrid::EnumerateGrids	(	int &	id,
		int &	pixel_offset
	)

virtual

Implements SensorGrid::SensorGridBase.

Definition at line 73 of file PndDiscSensorGrid.cxx.

References SensorGrid::SensorGridBase::grid_number, SensorGrid::SensorGridBase::number_of_pixels, and SensorGrid::SensorGridBase::pixel_number_offset.

                                                            {
 #ifdef OMERLE_SENSORGRID_DEBUG
     std::cout << "BasicGrid::EnumerateGrids\n";
 #endif
     // Set grid id and pixel number offset
     grid_number = id++;
     pixel_number_offset = pixel_offset;
     pixel_offset += number_of_pixels;
 }

void SensorGrid::SensorGridBase::EnumerateGridsProxy	(	SensorGridBase *	b,
		int &	grid_id,
		int &	pixel_number
	)

inlineprotectedinherited

Definition at line 68 of file PndDiscSensorGrid.h.

References SensorGrid::SensorGridBase::EnumerateGrids().

Referenced by SensorGrid::MultipleGrids::EnumerateGrids().

68 { b->EnumerateGrids(grid_id, pixel_number); }

b

TTree * b

Definition: GammaSpectraAnalysis.C:24

int SensorGrid::SensorGridBase::GetNumberOfPixels ( )

inlineinherited

Definition at line 56 of file PndDiscSensorGrid.h.

References SensorGrid::SensorGridBase::number_of_pixels.

Referenced by SensorGrid::SensorGridPhotodetector::GenerateNoise(), SensorGrid::SensorGridPhotodetector::GetNoiseHit(), SensorGrid::SensorGridPhotodetector::Init(), and SensorGrid::SensorGridPhotodetector::SetDCR().

56 { return number_of_pixels; }

SensorGrid::SensorGridBase::number_of_pixels

int number_of_pixels

user prowided offset to add to column on grid value in PixelInfo

Definition: PndDiscSensorGrid.h:77

bool SensorGrid::SensorGridBase::IsLocked ( )

inlineinherited

Definition at line 54 of file PndDiscSensorGrid.h.

References SensorGrid::SensorGridBase::locked.

54 { return locked; }

SensorGrid::SensorGridBase::locked

bool locked

The total number of pixels in this grid (or its childs)

Definition: PndDiscSensorGrid.h:78

virtual void SensorGrid::SensorGridBase::LockChilds ( bool )

inlineprotectedvirtualinherited

Reimplemented in SensorGrid::MultipleGrids.

Definition at line 64 of file PndDiscSensorGrid.h.

Referenced by SensorGrid::SensorGridBase::LockChildsProxy(), and SensorGrid::SensorGridBase::LockGrid().

64 {} // used to forward lock to children // lock//[R.K.03/2017] unused variable(s)

void SensorGrid::SensorGridBase::LockChildsProxy	(	SensorGridBase *	b,
		bool	lock
	)

inlineprotectedinherited

Definition at line 69 of file PndDiscSensorGrid.h.

References SensorGrid::SensorGridBase::LockChilds().

Referenced by SensorGrid::MultipleGrids::LockChilds().

69 { b->LockChilds(lock); }

b

TTree * b

Definition: GammaSpectraAnalysis.C:24

void SensorGrid::SensorGridBase::LockGrid ( bool lock )

inherited

Lock the grid:

Definition at line 19 of file PndDiscSensorGrid.cxx.

References SensorGrid::SensorGridBase::EnumerateGrids(), SensorGrid::SensorGridBase::LockChilds(), SensorGrid::SensorGridBase::locked, and SensorGrid::SensorGridBase::number_of_pixels.

Referenced by SensorGrid::SensorGridPhotodetector::Init().

                                        {
     if(lock == true) {
         // Enumerate this and all child grids:
         int grid_id = 1;
         int pixel_offset = number_of_pixels;
         EnumerateGrids(grid_id, pixel_offset);
         LockChilds(true);
 
         // and set lock flag
         locked = true;
     }
     else
         locked = false;
 }

bool SensorGrid::SensorGridBase::NextPixel	(	double &	x,
		double &	y,
		PixelInfo &	pixel_info
	)		const

virtualinherited

Return information of the next pixel (pixel iteration)

The pixel_info.pixel_number will be increased by one and the pixel_info structure is updated to the corresponding values. The position of the pixel center is also returned using arguments x, y.

Definition at line 40 of file PndDiscSensorGrid.cxx.

References SensorGrid::PixelInfo::pixel_number, and SensorGrid::SensorGridBase::PixelToPosition().

                                                                                    {
     // simple method that will work with all derived classes.
     // !!! maybe slow !!! -> derived classes should implement caching of last subgrid.
     if(pixel_info.pixel_number < 0) pixel_info.pixel_number = 0;     // start enum
     else ++pixel_info.pixel_number;            // run enum
     return PixelToPosition(pixel_info, x, y);
 }

bool SensorGrid::BasicGrid::PixelToPosition	(	PixelInfo &	pixel_info,
		double &	x,
		double &	y
	)		const

virtual

Compute the center-position of a pixel on this grid and update the pixel_info structure.

Implements SensorGrid::SensorGridBase.

Definition at line 127 of file PndDiscSensorGrid.cxx.

References SensorGrid::PixelInfo::column_on_grid, SensorGrid::PixelInfo::grid_id, SensorGrid::SensorGridBase::grid_number, n_x, SensorGrid::SensorGridBase::number_of_pixels, SensorGrid::PixelInfo::pixel_number, SensorGrid::SensorGridBase::pixel_number_offset, SensorGrid::PixelInfo::row_on_grid, SensorGrid::SensorGridBase::user_col_offset, SensorGrid::SensorGridBase::user_row_offset, x_min, x_pitch, y_min, and y_pitch.

                                                                                     {
     //std::cout << pixel_number_offset << "\t" << number_of_pixels << std::endl;
     int local_pixel_num = pixel_info.pixel_number-pixel_number_offset;
     if(pixel_info.pixel_number < pixel_number_offset || local_pixel_num >= number_of_pixels) return false;
 
     pixel_info.column_on_grid = local_pixel_num % n_x;
     pixel_info.row_on_grid    = local_pixel_num / n_x;
     pixel_info.grid_id        = grid_number;
 
     x = x_min + (0.5 + (double)(pixel_info.column_on_grid)) * x_pitch;
     y = y_min + (0.5 + (double)(pixel_info.row_on_grid)) * y_pitch;
 
     pixel_info.column_on_grid += user_col_offset;
     pixel_info.row_on_grid    += user_row_offset;
     return true;
 }

bool SensorGrid::BasicGrid::PositionToPixel	(	const double &	x,
		const double &	y,
		PixelInfo &	pixel_info
	)		const

virtual

Convert a hit position to a pixel number.

Implements SensorGrid::SensorGridBase.

Definition at line 103 of file PndDiscSensorGrid.cxx.

References SensorGrid::PixelInfo::column_on_grid, fabs(), SensorGrid::PixelInfo::grid_id, SensorGrid::SensorGridBase::grid_number, n_x, SensorGrid::PixelInfo::pixel_number, SensorGrid::SensorGridBase::pixel_number_offset, SensorGrid::PixelInfo::row_on_grid, SensorGrid::SensorGridBase::user_col_offset, SensorGrid::SensorGridBase::user_row_offset, x_max, x_min, x_pitch, x_width_over_two_pitch, y_max, y_min, y_pitch, and y_width_over_two_pitch.

                                                                                                 {
     if(x<x_min || x>x_max || y<y_min || y>y_max) return false;
 
     double x_coord_fp = (x-x_min)/x_pitch;
     double x_coord = floor(x_coord_fp);
     if(x_width_over_two_pitch < fabs(0.5-(x_coord_fp-x_coord))) return false;
 
     double y_coord_fp = (y-y_min)/y_pitch;
     double y_coord = floor(y_coord_fp);
     if(y_width_over_two_pitch < fabs(0.5-(y_coord_fp-y_coord))) return false;
 
     pixel_info.column_on_grid = (int)x_coord;
     pixel_info.row_on_grid    = (int)y_coord;
     pixel_info.pixel_number = pixel_info.column_on_grid + pixel_info.row_on_grid*n_x + pixel_number_offset;
 
     pixel_info.column_on_grid += user_col_offset;
     pixel_info.row_on_grid    += user_row_offset;
 
     pixel_info.grid_id = grid_number;
     return true;
 }

void SensorGrid::SensorGridBase::SetPixelNumberOffset ( int offset )

inlineprotectedinherited

Definition at line 65 of file PndDiscSensorGrid.h.

References offset(), and SensorGrid::SensorGridBase::pixel_number_offset.

65 { pixel_number_offset= offset; }

offset

TVector3 offset(2, 0, 0)

SensorGrid::SensorGridBase::pixel_number_offset

int pixel_number_offset

Definition: PndDiscSensorGrid.h:74

void SensorGrid::SensorGridBase::SetUserColumnOffset ( int ofs )

inlineinherited

Definition at line 51 of file PndDiscSensorGrid.h.

References SensorGrid::SensorGridBase::user_col_offset.

Referenced by DiscDIRC_Photodetector::Init().

51 { user_col_offset = ofs; }

SensorGrid::SensorGridBase::user_col_offset

int user_col_offset

user prowided offset to add to row on grid value in PixelInfo

Definition: PndDiscSensorGrid.h:76

void SensorGrid::SensorGridBase::SetUserRowOffset ( int ofs )

inlineinherited

Definition at line 52 of file PndDiscSensorGrid.h.

References SensorGrid::SensorGridBase::user_row_offset.

Referenced by DiscDIRC_Photodetector::Init().

52 { user_row_offset = ofs; }

SensorGrid::SensorGridBase::user_row_offset

int user_row_offset

The pixel number of the first pixel in this grid (or its childs)

Definition: PndDiscSensorGrid.h:75

void SensorGrid::BasicGrid::SetXDivision	(	const double &	x_min,
		const double &	x_width,
		const double &	x_pitch,
		int	n_x
	)

Definition at line 84 of file PndDiscSensorGrid.cxx.

References SensorGrid::SensorGridBase::locked, n_x, n_y, SensorGrid::SensorGridBase::number_of_pixels, x_max, x_min, x_pitch, x_width, and x_width_over_two_pitch.

                                                                                                               {
     if(locked) return; // todo: throw error
     x_min = x_min_; x_width = x_width_; x_pitch = x_pitch_; n_x = n_x_;
     x_width_over_two_pitch = x_width/(2.*x_pitch);
     x_max = x_min + double(n_x)*x_pitch;
     number_of_pixels = n_x*n_y;
 }

void SensorGrid::BasicGrid::SetYDivision	(	const double &	y_min,
		const double &	y_width,
		const double &	y_pitch,
		int	n_y
	)

Definition at line 93 of file PndDiscSensorGrid.cxx.

References SensorGrid::SensorGridBase::locked, n_x, n_y, SensorGrid::SensorGridBase::number_of_pixels, y_max, y_min, y_pitch, y_width, and y_width_over_two_pitch.

                                                                                                               {
     if(locked) return; // todo: throw error
     y_min = y_min_; y_width = y_width_; y_pitch = y_pitch_; n_y = n_y_;
     y_width_over_two_pitch = y_width/(2.*y_pitch);
     y_max = y_min + double(n_y)*y_pitch;
     number_of_pixels = n_x*n_y;
 }