TFC_acd.h File Reference

Interface to TKR->ACD projection and matching routines. More...

Functions
unsigned int	TFC_acdProject (TFC_prj *prj, int xCnt, int yCnt, const TFC_geometry *geo, int towerId, unsigned int dispatch, unsigned int acdxy[2][16], unsigned int acd_x, unsigned int acd_y, unsigned int acd_z)
	Projects the track projections to the ACD faces and looks for an match with a stuck ACD tile.
unsigned int	TFC_acdProjectTemplate (unsigned int acd_x, unsigned int acd_y, unsigned int acd_z)
	Builds a template dispatch mask for this event.

---

Detailed Description

Interface to TKR->ACD projection and matching routines.

Author:

JJRussell - russell@slac.stanford.edu

    CVS $Id: TFC_acd.h,v 1.3 2007/06/17 22:36:20 russell Exp $

---

Function Documentation

unsigned int TFC_acdProject	(	TFC_prj *	prj,
		int	xCnt,
		int	yCnt,
		const TFC_geometry *	geo,
		int	towerId,
		unsigned int	dispatch,
		unsigned int	acdxy[2][16],
		unsigned int	acd_x,
		unsigned int	acd_y,
		unsigned int	acd_z
	)

Projects the track projections to the ACD faces and looks for an match with a stuck ACD tile.

Returns:

The first coincidence with one of faces. The upper 4 bits indicate which face (0=Top, 1=X-, 2=X+, 3=Y-, 4=Y+), the lower N bits indicate the match (16 bits valid for side matches, 25 for top matches

Parameters:

	prj	The list of projections
	xCnt	The number of x projections. The first xCnt projections are X projections.
	yCnt	The number of y projections. The next yCnt projections are Y projections.
	geo	The geometry of the LAT. This is used to do the projections, defining where various boundaries are from the perspective of the TKR.
	towerId	The tower id of these projections
	dispatch	A bit mask of the possible projections to try based on the struck ACD tile. This must be consistent with acd_z, acd_x and acd_y.
	acdxy	Accumulates the or of all X/Y top tiles.
	acd_x	A bit mask of the struck ACD X face tiles.
	acd_y	A bit mask of the struck ACD Y face tiles.
	acd_z	A bit mask of the struck ACD Z (TOP) face tiles.

References ACD_M_PRJ_TOP, ACD_M_PRJ_XM, ACD_M_PRJ_XMS, ACD_M_PRJ_XP, ACD_M_PRJ_XPS, ACD_M_PRJ_YM, ACD_M_PRJ_YMS, ACD_M_PRJ_YP, ACD_M_PRJ_YPS, ACD_V_PRJ_TOP, ACD_V_PRJ_XM, ACD_V_PRJ_XP, ACD_V_PRJ_YM, ACD_V_PRJ_YP, prjAcd_Top(), prjAcd_XM(), prjAcd_XMS(), prjAcd_XP(), prjAcd_XPS(), prjAcd_YM(), prjAcd_YMS(), prjAcd_YP(), and prjAcd_YPS().

Referenced by tkrFilter().

unsigned int TFC_acdProjectTemplate	(	unsigned int	acd_x,
		unsigned int	acd_y,
		unsigned int	acd_z
	)

Builds a template dispatch mask for this event.

Returns:

The template dispatch mask for this event.

Parameters:

	acd_x	The bit mask of struck X+/- ACD tiles.
	acd_y	The bit mask of struck Y+/- ACD tiles.
	acd_z	The bit mask of struck Z (top) ACD tiles.

The dispatch mask is a bit mask of the possible ACD projections to consider. For example, if no top tiles are struck, there is no reason to even attempt to project the tracks to the top tile face. This calculation is broken out since this is a global property of the event. It is computed once, then used for each tower that has found projections.

References ACD_M_PRJ_TOP, ACD_M_PRJ_XM, ACD_M_PRJ_XMS, ACD_M_PRJ_XP, ACD_M_PRJ_XPS, ACD_M_PRJ_YM, ACD_M_PRJ_YMS, ACD_M_PRJ_YP, and ACD_M_PRJ_YPS.

Referenced by tkrFilter().