TUtimeJulian TCL UTILITIES USER MANUAL TUtimeJulian
SYNOPSIS
Compute the Julian time for a UT time
PACKAGE
TCLUTILS
NAME
TUtimeJulian
USAGE
TUtimeJulian  yR dY mS jT {RotMat}
INPUT DEFINITIONS
yR - The input year.
dY - Input day of year.
mS - Input millisecond of day.
jT - The output array. Element 0 in the array contains the equivalent Julian time for the input time. If the RotMat input has been set to 1 then the next 45 elements in the array contain the coordinate transformation matrices used in the TUdataCT procedure. The array can be directly input into TUdataCT. If the RotMat is set to 0 then the array only contains Julian time.
RotMat - This is an optional input which is initialized to 0. If set to 1 then the output array jT is build to be input into the TUdataCT procedure otherwise only the Julian time is returned in the array.
RETURN DEFINITION
None
DESCRIPTION
TUtimeJulian returns the Julian time associated with a the given input time. The Julian time is returned in element 0 of the array jT. If RotMat is set to 1 in the call then the array jT is built to also contain the rotation matrices used in the TUataCT procedure. Its format is such that it can be directly input into TUdataCT as is. This is useful if there are a number of rotations to be made at the same time. It prevents TUdataCT from recomputing the matrices with each call.
ERRORS
None Generated
C BACKING
No
EXAMPLE(S)
# SOLVE for a Julian Time

TUtimeJulian 2005 133 0 jT
puts stderr "Julian time for 2005 133 0     is $jT(0)"
TUtimeJulian 2001 267 10101 jT
puts stderr "Julian time for 2001 267 10101 is $jT(0)"

> Julian time for 2005 133 0     is 53503.0
> Julian time for 2001 267 10101 is 52176.0001169

      
Dec 7, 2006