Fast locator class for SuperNEMO main calorimeter scintillator block volumes. More...

#include <falaise/snemo/geometry/calo_locator.h>

Inheritance diagram for snemo::geometry::calo_locator:

Public Types
enum	block_part_type { BLOCK_BACK_PART = 0, BLOCK_FRONT_PART = 1, DEFAULT_BLOCK_PART = BLOCK_FRONT_PART }
	Block part identifier (for geometry config snemo::demonstrator >=2.0) More...

Public Types inherited from datatools::i_tree_dumpable
enum	ostream_type

Public Member Functions
virtual bool	is_initialized () const

	calo_locator ()
	Default constructor. More...

	calo_locator (const ::geomtools::manager &mgr_, uint32_t module_number_, uint32_t block_part_=DEFAULT_BLOCK_PART)
	Constructor. More...

virtual	~calo_locator ()
	Destructor. More...

virtual void	initialize (const datatools::properties &config_)
	Initialization from parameters. More...

virtual void	reset ()
	Reset. More...

void	initialize ()
	Initialization. More...

bool	has_submodule (uint32_t side_) const
	Check if the calorimeter setup includes submodule with given side number. More...

bool	id_is_valid (uint32_t side_, uint32_t column_, uint32_t row_) const
	Check if a set of calorimeter block identifiers is valid. More...

virtual bool	find_geom_id (const geomtools::vector_3d &world_position_, int type_, geomtools::geom_id &gid_, double tolerance_=GEOMTOOLS_PROPER_TOLERANCE) const

bool	find_block_geom_id (const geomtools::vector_3d &world_position_, geomtools::geom_id &gid_, double tolerance_=GEOMTOOLS_PROPER_TOLERANCE) const

uint32_t	get_module_number () const

void	set_module_number (uint32_t module_number_)

void	set_block_part (uint32_t block_part_)

uint32_t	get_block_part () const

bool	is_block_partitioned () const

double	get_block_width () const

double	get_block_height () const

double	get_block_thickness () const

size_t	get_number_of_sides () const

size_t	get_number_of_columns (uint32_t side_) const

size_t	get_number_of_rows (uint32_t side_) const

double	get_wall_x (uint32_t side_) const

double	get_wall_window_x (uint32_t side_) const

double	get_column_y (uint32_t side_, uint32_t column_) const

double	get_row_z (uint32_t side_, uint32_t row_) const

void	compute_block_position (uint32_t side_, uint32_t column_, uint32_t row_, geomtools::vector_3d &module_position_) const

void	compute_block_window_position (uint32_t side_, uint32_t column_, uint32_t row_, geomtools::vector_3d &module_position_) const

geomtools::vector_3d	get_block_position (uint32_t side_, uint32_t column_, uint32_t row_) const

geomtools::vector_3d	get_block_window_position (uint32_t side_, uint32_t column_, uint32_t row_) const

void	transform_world_to_module (const geomtools::vector_3d &world_position_, geomtools::vector_3d &module_position_) const

void	transform_module_to_world (const geomtools::vector_3d &module_position_, geomtools::vector_3d &world_position_) const

bool	is_world_position_in_module (const geomtools::vector_3d &world_position_, double tolerance_=GEOMTOOLS_PROPER_TOLERANCE) const

bool	is_in_module (const geomtools::vector_3d &module_position_, double tolerance_=GEOMTOOLS_PROPER_TOLERANCE) const

bool	is_in_block (const geomtools::vector_3d &module_position_, uint32_t side_, uint32_t column_, uint32_t row_, double tolerance_=GEOMTOOLS_PROPER_TOLERANCE) const

bool	is_world_position_in_block (const geomtools::vector_3d &world_position_, uint32_t side_, uint32_t column_, uint32_t row_, double tolerance_=GEOMTOOLS_PROPER_TOLERANCE) const

size_t	get_number_of_neighbours (uint32_t side_, uint32_t column_, uint32_t row_, uint8_t mask_=utils::NEIGHBOUR_FIRST) const

size_t	get_number_of_neighbours (const geomtools::geom_id &gid_, uint8_t mask_=utils::NEIGHBOUR_FIRST) const

void	get_neighbours_ids (uint32_t side_, uint32_t column_, uint32_t row_, std::vector< geomtools::geom_id > &ids_, uint8_t mask_=utils::NEIGHBOUR_FIRST) const

void	get_neighbours_ids (const geomtools::geom_id &gid_, std::vector< geomtools::geom_id > &ids_, uint8_t mask_=utils::NEIGHBOUR_FIRST) const

void	get_block_position (const geomtools::geom_id &gid_, geomtools::vector_3d &position_) const

void	get_block_position (uint32_t side_, uint32_t column_, uint32_t row_, geomtools::vector_3d &position_) const

int	get_module_address_index () const

int	get_side_address_index () const

int	get_column_address_index () const

int	get_row_address_index () const

int	get_part_address_index () const

uint32_t	extract_module (const geomtools::geom_id &gid_) const

uint32_t	extract_side (const geomtools::geom_id &gid_) const

uint32_t	extract_column (const geomtools::geom_id &gid_) const

uint32_t	extract_row (const geomtools::geom_id &gid_) const

uint32_t	extract_part (const geomtools::geom_id &gid_) const

bool	is_calo_block (const geomtools::geom_id &gid_) const

bool	is_calo_block_in_current_module (const geomtools::geom_id &gid_) const

virtual void	tree_dump (std::ostream &out_=std::clog, const std::string &title_="", const std::string &indent_="", bool inherit_=false) const
	Smart print. More...

void	dump (std::ostream &out_) const
	Dump. More...

Public Member Functions inherited from geomtools::base_locator
	base_locator ()

virtual	~base_locator ()

bool	has_geo_manager () const

void	set_geo_manager (const manager &mgr_)

const manager &	get_geo_manager () const

datatools::logger::priority	get_logging_priority () const

void	set_logging_priority (datatools::logger::priority)

Public Member Functions inherited from datatools::i_tree_dumpable
	i_tree_dumpable ()

virtual	~i_tree_dumpable ()

virtual void	print_tree (std::ostream &out_=std::clog, const boost::property_tree::ptree &options_=empty_options()) const

void	print_tree_json (std::ostream &out_=std::clog, const std::string &json_options_="") const

void	print_tree_json (std::ostream &out_=std::clog, const char *json_options_=nullptr) const

void	tree_dump_id (const int out_type_=OSTREAM_CLOG, const std::string &title_="", const std::string &indent_="", const bool inherit_=false) const

void	tree_print_id (const int out_type_=OSTREAM_CLOG, const std::string &title_="") const

void	smart_print_id (const int out_type_=OSTREAM_CLOG, const std::string &title_="", const std::string &indent_="") const

Protected Member Functions
bool	find_block_geom_id_ (const geomtools::vector_3d &in_module_position_, geomtools::geom_id &gid_, double tolerance_=GEOMTOOLS_PROPER_TOLERANCE)

void	_set_defaults_ ()

void	_construct ()

void	_hack_trace ()
	Hack trace. More...

Protected Member Functions inherited from geomtools::base_locator
void	_basic_initialize (const datatools::properties &config_)

Additional Inherited Members
Static Public Member Functions inherited from datatools::i_tree_dumpable
static const boost::property_tree::ptree &	empty_options ()

static boost::property_tree::ptree	make_base_print_options (const std::string &title_, const std::string &indent_="", const bool inherit_=false)

static std::ostream &	last_skip_tag (std::ostream &out_)

static std::ostream &	skip_tag (std::ostream &out_)

static std::ostream &	last_tag (std::ostream &out_)

static std::ostream &	tag (std::ostream &out_)

Public Attributes inherited from datatools::i_tree_dumpable
	OSTREAM_COUT

	OSTREAM_CERR

	OSTREAM_CLOG

Protected Attributes inherited from geomtools::base_locator
datatools::logger::priority	_logging_priority

Detailed Description

Fast locator class for SuperNEMO main calorimeter scintillator block volumes.

Member Enumeration Documentation

◆ block_part_type

enum snemo::geometry::calo_locator::block_part_type

Block part identifier (for geometry config snemo::demonstrator >=2.0)

Enumerator
BLOCK_BACK_PART
BLOCK_FRONT_PART	Back volume of scintillator (possibly extruded)
DEFAULT_BLOCK_PART	Front volume of scintillator (entrance window)

Constructor & Destructor Documentation

◆ calo_locator() [1/2]

snemo::geometry::calo_locator::calo_locator ( )

Default constructor.

◆ calo_locator() [2/2]

snemo::geometry::calo_locator::calo_locator	(	const ::geomtools::manager &	mgr_,
		uint32_t	module_number_,
		uint32_t	block_part_ = `DEFAULT_BLOCK_PART`
	)

Constructor.

◆ ~calo_locator()

virtual snemo::geometry::calo_locator::~calo_locator ( )

virtual

Destructor.

Member Function Documentation

◆ _construct()

void snemo::geometry::calo_locator::_construct ( )

protected

◆ _hack_trace()

void snemo::geometry::calo_locator::_hack_trace ( )

protected

Hack trace.

◆ _set_defaults_()

void snemo::geometry::calo_locator::_set_defaults_ ( )

protected

◆ compute_block_position()

void snemo::geometry::calo_locator::compute_block_position	(	uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_,
		geomtools::vector_3d &	module_position_
	)		const

! Compute the position of a block for specific side, column and row (in module coordinate system).

◆ compute_block_window_position()

void snemo::geometry::calo_locator::compute_block_window_position	(	uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_,
		geomtools::vector_3d &	module_position_
	)		const

! Compute the position of the center of the entrance window of a block for specific side, column and row (in module coordinate system).

◆ dump()

void snemo::geometry::calo_locator::dump ( std::ostream & out_ ) const

Dump.

◆ extract_column()

uint32_t snemo::geometry::calo_locator::extract_column ( const geomtools::geom_id & gid_ ) const

◆ extract_module()

uint32_t snemo::geometry::calo_locator::extract_module ( const geomtools::geom_id & gid_ ) const

◆ extract_part()

uint32_t snemo::geometry::calo_locator::extract_part ( const geomtools::geom_id & gid_ ) const

◆ extract_row()

uint32_t snemo::geometry::calo_locator::extract_row ( const geomtools::geom_id & gid_ ) const

◆ extract_side()

uint32_t snemo::geometry::calo_locator::extract_side ( const geomtools::geom_id & gid_ ) const

◆ find_block_geom_id()

bool snemo::geometry::calo_locator::find_block_geom_id	(	const geomtools::vector_3d &	world_position_,
		geomtools::geom_id &	gid_,
		double	tolerance_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)		const

◆ find_block_geom_id_()

bool snemo::geometry::calo_locator::find_block_geom_id_	(	const geomtools::vector_3d &	in_module_position_,
		geomtools::geom_id &	gid_,
		double	tolerance_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)

protected

◆ find_geom_id()

virtual bool snemo::geometry::calo_locator::find_geom_id	(	const geomtools::vector_3d &	world_position_,
		int	type_,
		geomtools::geom_id &	gid_,
		double	tolerance_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)		const

virtual

Implements geomtools::base_locator.

◆ get_block_height()

double snemo::geometry::calo_locator::get_block_height ( ) const

!

Returns: the height of a calorimeter block.

◆ get_block_part()

uint32_t snemo::geometry::calo_locator::get_block_part ( ) const

! return the block part number for this locator.

◆ get_block_position() [1/3]

geomtools::vector_3d snemo::geometry::calo_locator::get_block_position	(	uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_
	)		const

!

Returns: the position of a block for specific side, column and row (in module coordinate system).

◆ get_block_position() [2/3]

void snemo::geometry::calo_locator::get_block_position	(	const geomtools::geom_id &	gid_,
		geomtools::vector_3d &	position_
	)		const

Given a block with a specific geometry IDs, compute its position in the module coordinate system.

◆ get_block_position() [3/3]

void snemo::geometry::calo_locator::get_block_position	(	uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_,
		geomtools::vector_3d &	position_
	)		const

Given a block with a specific side, column and row, compute its position in the module coordinate system.

◆ get_block_thickness()

double snemo::geometry::calo_locator::get_block_thickness ( ) const

!

Returns: the thickness of a block.

◆ get_block_width()

double snemo::geometry::calo_locator::get_block_width ( ) const

!

Returns: the width of a calorimeter block.

◆ get_block_window_position()

geomtools::vector_3d snemo::geometry::calo_locator::get_block_window_position	(	uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_
	)		const

!

Returns: the position of the center of the entrance window of a block for specific side, column and row (in module coordinate system).

◆ get_column_address_index()

int snemo::geometry::calo_locator::get_column_address_index ( ) const

◆ get_column_y()

double snemo::geometry::calo_locator::get_column_y	(	uint32_t	side_,
		uint32_t	column_
	)		const

!

Returns: the Y-position of a block for specific side and column (in module coordinate system).

◆ get_module_address_index()

int snemo::geometry::calo_locator::get_module_address_index ( ) const

◆ get_module_number()

uint32_t snemo::geometry::calo_locator::get_module_number ( ) const

!

Returns: the number of the module(>=0).

◆ get_neighbours_ids() [1/2]

void snemo::geometry::calo_locator::get_neighbours_ids	(	uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_,
		std::vector< geomtools::geom_id > &	ids_,
		uint8_t	mask_ = `utils::NEIGHBOUR_FIRST`
	)		const

Given a block at specific side, column and row, compute the array of geometry IDs for associated neighbouring blocks.

◆ get_neighbours_ids() [2/2]

void snemo::geometry::calo_locator::get_neighbours_ids	(	const geomtools::geom_id &	gid_,
		std::vector< geomtools::geom_id > &	ids_,
		uint8_t	mask_ = `utils::NEIGHBOUR_FIRST`
	)		const

Given a block with a specific geometry IDs, compute the array of geometry IDs for associated neighbouring blocks.

◆ get_number_of_columns()

size_t snemo::geometry::calo_locator::get_number_of_columns ( uint32_t side_ ) const

!

Returns: the number of columns in one side of the calorimeter.

◆ get_number_of_neighbours() [1/2]

size_t snemo::geometry::calo_locator::get_number_of_neighbours	(	uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_,
		uint8_t	mask_ = `utils::NEIGHBOUR_FIRST`
	)		const

Given a block at specific side, column and row, returns the number of neighbouring blocks.

◆ get_number_of_neighbours() [2/2]

size_t snemo::geometry::calo_locator::get_number_of_neighbours	(	const geomtools::geom_id &	gid_,
		uint8_t	mask_ = `utils::NEIGHBOUR_FIRST`
	)		const

Given a block with a specific geometry ID, returns the number of neighbouring blocks.

◆ get_number_of_rows()

size_t snemo::geometry::calo_locator::get_number_of_rows ( uint32_t side_ ) const

!

Returns: the number of rows in one side of the calorimeter.

◆ get_number_of_sides()

size_t snemo::geometry::calo_locator::get_number_of_sides ( ) const

!

Returns: the number of sides on the calorimeter.

◆ get_part_address_index()

int snemo::geometry::calo_locator::get_part_address_index ( ) const

◆ get_row_address_index()

int snemo::geometry::calo_locator::get_row_address_index ( ) const

◆ get_row_z()

double snemo::geometry::calo_locator::get_row_z	(	uint32_t	side_,
		uint32_t	row_
	)		const

!

Returns: the Z-position of a block for specific side and row (in module coordinate system).

◆ get_side_address_index()

int snemo::geometry::calo_locator::get_side_address_index ( ) const

◆ get_wall_window_x()

double snemo::geometry::calo_locator::get_wall_window_x ( uint32_t side_ ) const

!

Returns: the X-position of the entrance window of a wall for specific side (in module coordinate system).

◆ get_wall_x()

double snemo::geometry::calo_locator::get_wall_x ( uint32_t side_ ) const

!

Returns: the X-position of a wall for specific side (in module coordinate system).

◆ has_submodule()

bool snemo::geometry::calo_locator::has_submodule ( uint32_t side_ ) const

Check if the calorimeter setup includes submodule with given side number.

◆ id_is_valid()

bool snemo::geometry::calo_locator::id_is_valid	(	uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_
	)		const

Check if a set of calorimeter block identifiers is valid.

◆ initialize() [1/2]

virtual void snemo::geometry::calo_locator::initialize ( const datatools::properties & config_ )

virtual

Initialization from parameters.

Implements geomtools::base_locator.

◆ initialize() [2/2]

void snemo::geometry::calo_locator::initialize ( )

Initialization.

◆ is_block_partitioned()

bool snemo::geometry::calo_locator::is_block_partitioned ( ) const

! check if block is partitioned in the current setup.

◆ is_calo_block()

bool snemo::geometry::calo_locator::is_calo_block ( const geomtools::geom_id & gid_ ) const

◆ is_calo_block_in_current_module()

bool snemo::geometry::calo_locator::is_calo_block_in_current_module ( const geomtools::geom_id & gid_ ) const

◆ is_in_block()

bool snemo::geometry::calo_locator::is_in_block	(	const geomtools::vector_3d &	module_position_,
		uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_,
		double	tolerance_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)		const

Check if a module coordinate system position is in a specific block virtual volume (its bounding envelope).

◆ is_in_module()

bool snemo::geometry::calo_locator::is_in_module	(	const geomtools::vector_3d &	module_position_,
		double	tolerance_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)		const

Check if a module coordinate system position is in the module virtual volume (its bounding envelope).

◆ is_initialized()

virtual bool snemo::geometry::calo_locator::is_initialized ( ) const

virtual

Implements geomtools::base_locator.

◆ is_world_position_in_block()

bool snemo::geometry::calo_locator::is_world_position_in_block	(	const geomtools::vector_3d &	world_position_,
		uint32_t	side_,
		uint32_t	column_,
		uint32_t	row_,
		double	tolerance_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)		const

Check if a world coordinate system position is in a specific block virtual volume (its bounding envelope).

◆ is_world_position_in_module()

bool snemo::geometry::calo_locator::is_world_position_in_module	(	const geomtools::vector_3d &	world_position_,
		double	tolerance_ = `GEOMTOOLS_PROPER_TOLERANCE`
	)		const

Check if a world coordinate system position is in the module virtual volume (its bounding envelope).

◆ reset()

virtual void snemo::geometry::calo_locator::reset ( )

virtual

Reset.

Implements geomtools::base_locator.

◆ set_block_part()

void snemo::geometry::calo_locator::set_block_part ( uint32_t block_part_ )

! set the block part number for this locator.

◆ set_module_number()

void snemo::geometry::calo_locator::set_module_number ( uint32_t module_number_ )

! set the number of the module for this locator.

◆ transform_module_to_world()

void snemo::geometry::calo_locator::transform_module_to_world	(	const geomtools::vector_3d &	module_position_,
		geomtools::vector_3d &	world_position_
	)		const

Tranform a module coordinate system position to the corresponding world coordinate system position.

◆ transform_world_to_module()

void snemo::geometry::calo_locator::transform_world_to_module	(	const geomtools::vector_3d &	world_position_,
		geomtools::vector_3d &	module_position_
	)		const

Tranform a world coordinate system position to the corresponding module coordinate system position.

◆ tree_dump()

virtual void snemo::geometry::calo_locator::tree_dump	(	std::ostream &	out_ = `std::clog`,
		const std::string &	title_ = `""`,
		const std::string &	indent_ = `""`,
		bool	inherit_ = `false`
	)		const

virtual

Smart print.

Reimplemented from datatools::i_tree_dumpable.

The documentation for this class was generated from the following file:

falaise/snemo/geometry/calo_locator.h

Public Types

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ block_part_type

Constructor & Destructor Documentation

◆ calo_locator() [1/2]

◆ calo_locator() [2/2]

◆ ~calo_locator()

Member Function Documentation

◆ _construct()

◆ _hack_trace()

◆ _set_defaults_()

◆ compute_block_position()

◆ compute_block_window_position()

◆ dump()

◆ extract_column()

◆ extract_module()

◆ extract_part()

◆ extract_row()

◆ extract_side()

◆ find_block_geom_id()

◆ find_block_geom_id_()

◆ find_geom_id()

◆ get_block_height()

◆ get_block_part()

◆ get_block_position() [1/3]

◆ get_block_position() [2/3]

◆ get_block_position() [3/3]

◆ get_block_thickness()

◆ get_block_width()

◆ get_block_window_position()

◆ get_column_address_index()

◆ get_column_y()

◆ get_module_address_index()

◆ get_module_number()

◆ get_neighbours_ids() [1/2]

◆ get_neighbours_ids() [2/2]

◆ get_number_of_columns()

◆ get_number_of_neighbours() [1/2]

◆ get_number_of_neighbours() [2/2]

◆ get_number_of_rows()

◆ get_number_of_sides()

◆ get_part_address_index()

◆ get_row_address_index()

◆ get_row_z()

◆ get_side_address_index()

◆ get_wall_window_x()

◆ get_wall_x()

◆ has_submodule()

◆ id_is_valid()

◆ initialize() [1/2]

◆ initialize() [2/2]

◆ is_block_partitioned()

◆ is_calo_block()

◆ is_calo_block_in_current_module()

◆ is_in_block()

◆ is_in_module()

◆ is_initialized()

◆ is_world_position_in_block()

◆ is_world_position_in_module()

◆ reset()

◆ set_block_part()

◆ set_module_number()

◆ transform_module_to_world()

◆ transform_world_to_module()

◆ tree_dump()