Reconstruction Notes

CAVEAT: Basically, I'm just using these pages as a notepad. The idea is to make the doxygen generated commets reflect the stuff here eventually

Geometrical Functions

pointPoca(const Track& track, const Point& point, arcLength, doca, Point& poca)

Gets the point of closest approach between a track projection and a space point.

Inputs:
track -> the track projectection data
point -> the point in question

Outputs:
    arcLength -> distance along the track where the poca occurs => poca = track.m_point + arcLength * track.m_dir
doca         -> distance of clostest approach == | point - poca |
    poca         -> the point of closest approach

crossesPlane(const Track& track, const Point& plane, int face, arcLength, localX,localY, Point& hitPoint)

Gets the point where a track projection crosses a plane

Inputs:
    track -> the track projectection data
    point -> point at the center of the plane
    face   -> enum which defines the orientation/ side of the LAT the plane is on (top=0, -Y, -X, +Y, +X, bottom)

Outputs:
    arcLength -> distance along the track where the plane is crossed occurs => hitPoint = track.m_point + arcLength * track.m_dir
localX       -> position of the crossing point relative to the plane center
    localY
    hitPoint     -> the point where the track projection crosses the plane

tilePlane(const Track& track, const Tile& tile, double& arcLength, localX, localY,activeX, activeY, active2D, Point& hitPoint)

Gets the point where a track projection crosses a tile

Inputs:
track -> the track projectection data
tile -> the geomertical informatio about the tile

Outputs:
    arcLength -> distance along the track where the plane is crossed occurs => hitPoint = track.m_point + arcLength * track.m_dir
localX       -> position of the crossing point relative to the plane center
    localY
    activeX     -> position of the crossing point relative to the edge of the active area ( >0 is in active area)
    activeY
    active2D -> the larger of activeX and activeY
    hitPoint     -> the point where the track projection crosses the plane

tileEdgePoca(const Track& track, const Tile& tile, double& arcLength, dist, Point& poca, Vector& vector, int& region)

Gets the point where a track projection (that goes inside a tile) comes closest one of the edges of the tile