org.lcsim.recon.tracking.trfbase

Class TrackDerivative

java.lang.Object

org.lcsim.recon.tracking.trfbase.TrackDerivative

public class TrackDerivative
extends Object

Class TrackDerivative is the derivative of one track vector with respect to another; i.e. a non-symmetric 5x5 matrix.

TrackDerivative should support the following operations:

 construct: tv(), te(), td() (should fill with zeros)
 copy: tv2(tv1), te2(te1), td2(td1)
 assignment: tv2 = tv2, te2 = te1, td2 = td1
 indexing: tv(i), te(i,j), td(i,j)
 minimum element: tv.min(), te.min(), td.min()
 maximum element: tv.max(), te.max(), td.max()
 absolute minimum element: tv.amin(), te.amin(), td.amin()
 absolute maximum element: tv.amax(), te.amax(), td.amax()
 addition: tv2 += tv1, tv3 = tv1 + tv2,
           te2 += te1, te3 = tv1 + te2,
           td2 += td1, td3 = td1 + td2,
 subtraction: tv2 -= tv1, tv3 = tv1 - tv2,
              te2 -= te1, te3 = tv1 - te2,
              td2 -= td1, td3 = td1 - td2,
 inversion: int stat = invert( TrackError& te1 ) (0 for success)
 output stream: cout << tv << te << td
 equality: tv1==tv2, te1==te2, td1==td2
 inequality: tv!=tv2, te1!=te2, td1!=td2
 chisquare difference: chisq_diff(tv,te) = tv_T * te * tv
 (tv is the difference between two vectors and te is the inverse
 of the error matrix.)
 transpose: td.transpose()
 transform: te.xform(td)
 

Version:

1.0

Author:

Norman A. Graf

Field Summary

Fields

Modifier and Type	Field and Description
private Matrix	_mat
private int	_size

Constructor Summary

Constructors

Constructor and Description
TrackDerivative() Default constructor creates 5x5 matrix of zeros
TrackDerivative(double[][] mat) Constructor from array
TrackDerivative(Matrix mat) Constructor from Jama Matrix.
TrackDerivative(TrackDerivative td) Copy constructor

Method Summary

Methods

Modifier and Type	Method and Description
double	amax() Absolute maximum TrackDerivative element.
double	amin() Absolute minimum TrackDerivative element.
boolean	equals(TrackDerivative td) Equality.
double	get(int i, int j) Get an element of the TrackDerivative.
Matrix	getMatrix() Return the TrackDerivative as a Jama Matrix.
boolean	isEqual(TrackDerivative td) Equality within tolerance.
double[][]	matrix() Return the underlying matrix.
double	max() Maximum TrackDerivative element.
double	min() Minimum TrackDerivative element.
TrackDerivative	minus(TrackDerivative td) Math function minus.
boolean	notEquals(TrackDerivative td) Inequality convenience method.
TrackDerivative	plus(TrackDerivative td) Math function plus.
void	set(int i, int j, double val) Set an element of the TrackDerivative.
void	set(TrackDerivative td) Set the elements equal to those of an existing TrackDerivative.
void	setIdentity() Convenience method to set TrackDerivative to the identity.
TrackDerivative	times(TrackDerivative td) Matrix multiply
String	toString() String representation of TrackDerivative.
void	transpose() Matrix transpose.

Methods inherited from class java.lang.Object

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

Field Detail

_mat

private Matrix _mat

_size

private int _size

Constructor Detail

TrackDerivative

public TrackDerivative()

Default constructor creates 5x5 matrix of zeros

TrackDerivative

public TrackDerivative(double[][] mat)

Constructor from array

Parameters:

mat - 5x5 array of doubles.

TrackDerivative

public TrackDerivative(Matrix mat)

Constructor from Jama Matrix.

Parameters:

mat - 5x5 Jama Matrix.

TrackDerivative

public TrackDerivative(TrackDerivative td)

Copy constructor

Parameters:

td - TrackDerivative to copy.

Method Detail

matrix

public double[][] matrix()

Return the underlying matrix.

Returns:

5x5 array of doubles.

toString

public String toString()

String representation of TrackDerivative.

Overrides:

toString in class Object

Returns:

String representation of TrackDerivative.

getMatrix

public Matrix getMatrix()

Return the TrackDerivative as a Jama Matrix.

Returns:

5x5 Jama Matrix.

set

public void set(int i,
       int j,
       double val)

Set an element of the TrackDerivative.

Parameters:

i - Row index.

j - Column index.

val - Value of element (i,j).

set

public void set(TrackDerivative td)

Set the elements equal to those of an existing TrackDerivative.

Parameters:

td - TrackDerivative to be equivalent to.

get

public double get(int i,
         int j)

Get an element of the TrackDerivative.

Parameters:

i - Row index.

j - Column index.

Returns:

Value of element (i,j).

setIdentity

public void setIdentity()

Convenience method to set TrackDerivative to the identity.

times

public TrackDerivative times(TrackDerivative td)

Matrix multiply

Parameters:

td - TrackDerivative by which to multiply.

Returns:

this times TrackDerivative td.

amax

public double amax()

Absolute maximum TrackDerivative element.

Returns:

absolute value of absolute maximum TrackDerivative element.

max

public double max()

Maximum TrackDerivative element.

Returns:

Maximum TrackDerivative element.

min

public double min()

Minimum TrackDerivative element.

Returns:

minimum TrackDerivative element.

amin

public double amin()

Absolute minimum TrackDerivative element.

Returns:

absolute value of absolute minimum TrackDerivative element.

minus

public TrackDerivative minus(TrackDerivative td)

Math function minus.

Parameters:

td - TrackDerivative to be subtracted.

Returns:

this minus TrackDerivative td.

plus

public TrackDerivative plus(TrackDerivative td)

Math function plus.

Parameters:

td - TrackDerivative to be added.

Returns:

this plus TrackDerivative td.

equals

public boolean equals(TrackDerivative td)

Equality.

Parameters:

td - TrackDerivative to compare

Returns:

true if TrackDerivatives are equal.

notEquals

public boolean notEquals(TrackDerivative td)

Inequality convenience method.

Parameters:

td - TrackDerivative to compare

Returns:

true if TrackDerivatives are not equal.

isEqual

public boolean isEqual(TrackDerivative td)

Equality within tolerance.

Parameters:

td - TrackDerivative to compare

Returns:

true if TrackDerivatives are equal within tolerance.

transpose

public void transpose()

Matrix transpose. Transposes rows and columns of TrackDerivative in place.