org.lcsim.recon.tracking.gtrbase

Class GTrack

java.lang.Object

org.lcsim.recon.tracking.gtrbase.GTrack

public class GTrack
extends Object

This class describes a global track consisting of a list of states which specify the fit and hit or miss at different points along the track trajectory. See GTrackState for a more complete description of the states.

Version:

1.0

Author:

Norman A. Graf

Field Summary

Fields

Modifier and Type	Field and Description
private static Propagator	_prop
private TreeSet	_states
private boolean	_valid
(package private) static GTrackState	BAD_STATE
(package private) static double	SMAX
(package private) static double	SMIN

Constructor Summary

Constructors

Constructor and Description
GTrack() Construct a default instance.
GTrack(GTrack gtr) Construct a replica of the GTrack (copy constructor).
GTrack(TreeSet states) Construct an instance from a list of states.

Method Summary

Methods

Modifier and Type	Method and Description
int	dropFit(double s) Drop the fit for the state at the specified path distance s.
boolean	equals(GTrack gtr) Test equality.
boolean	isValid() Check the tracks validity.
boolean	notEquals(GTrack gtr) Test equality.
(package private) int	numberOfMeasurements()
GTrackState	state(double s) Return a state at a path distance s.
GTrackState	state(Surface srf) Return the existing state at a particular surface.
GTrackState	state(Surface srf, double s1, double s2) Return the existing state at a particular surface.
TreeSet	states() Return the list of states.
String	toString() output stream
void	update(TreeSet states) Rebuild the existing track from new set of GTrackStates (needed for Java's inability to modify local handles)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

SMIN

static final double SMIN

See Also:

Constant Field Values

SMAX

static final double SMAX

See Also:

Constant Field Values

BAD_STATE

static final GTrackState BAD_STATE

_prop

private static Propagator _prop

_valid

private boolean _valid

_states

private TreeSet _states

Constructor Detail

GTrack

public GTrack()

Construct a default instance. Leaves object in an invalid state.

GTrack

public GTrack(TreeSet states)

Construct an instance from a list of states. Track is set valid if all states meet the following: 1. have SMIN <= s <= SMAX 2. are valid 3. have valid fits (not INVALID)

Parameters:

states - The list of track states.

GTrack

public GTrack(GTrack gtr)

Construct a replica of the GTrack (copy constructor).

Parameters:

gtr - The GTrack to replicate.

Method Detail

update

public void update(TreeSet states)

Rebuild the existing track from new set of GTrackStates (needed for Java's inability to modify local handles)

Parameters:

states - The list of GTrackStates.

dropFit

public int dropFit(double s)

Drop the fit for the state at the specified path distance s.

Parameters:

s - The path distance at which to drop a fit.

Returns:

0 for success.

isValid

public boolean isValid()

Check the tracks validity.

Returns:

true if the GTrack is valid.

states

public TreeSet states()

Return the list of states.

Returns:

The list of states.

state

public GTrackState state(double s)

Return a state at a path distance s.

Parameters:

s - The path distance for which to return a state.

Returns:

an invalid state if there is no state at that s.

state

public GTrackState state(Surface srf)

Return the existing state at a particular surface. The first match with SMIN <= s < SMAX is returned. A reference to an invalid state is returned if the surface cannot be matched. Surface bounds are not required to match.

Parameters:

srf - The surface for which to return a state.

Returns:

an invalid state if there is no state at that s.

state

public GTrackState state(Surface srf,
                double s1,
                double s2)

Return the existing state at a particular surface. The first match with s1 <= s < s2 is returned. A reference to an invalid state is returned if the surface cannot be matched. Surface bounds are not required to match. *

Parameters:

srf - The surface for which to return a state.

s1 - The lower bound on the path distance.

s2 - The upper bound on the path distance.

Returns:

an invalid state if there is no state betwee s1 and s2.

numberOfMeasurements

int numberOfMeasurements()

toString

public String toString()

output stream

Overrides:

toString in class Object

Returns:

A String representation of this instance.

equals

public boolean equals(GTrack gtr)

Test equality.

Parameters:

gtr - The GTrack to test.

Returns:

true if the tracks are equal.

notEquals

public boolean notEquals(GTrack gtr)

Test equality.

Parameters:

gtr - The GTrack to test.

Returns:

true if the tracks are not equal.