atSurveyGeometry
ABSTRACT: coordinate transformations: equatorial to and from
great circle, galactic, and great circle. Also a
verb to access useful values of the survey geometry and
conversion constants.
Routines for coordinate conversions and survey geometry
C ROUTINE CALLED:
atEqToGC in atSurveyGeometry.c
TCL SYNTAX:
eqToGC "<ra>" "<dec>" "-node" "-inclination"
TCL HELP STRING:
convert equatorial to great circle coordinates, in decimal degrees.
RETURN a keyed list of mu and nu.
TCL ARGUMENTS:
:
"<ra>" : right ascension
"<dec>" : declination
"-node" : node of the reference great circle
"-inclination" : inclination of the reference great circle
C ROUTINE CALLED:
atGCToEq in atSurveyGeometry.c
TCL SYNTAX:
GCToEq "<mu>" "<nu>" "-node" "-inclination"
TCL HELP STRING:
Convert great circle to equatorial coordinates, in decimal degrees
TCL ARGUMENTS:
:
"<mu>" : mu on the great circle
"<nu>" : nu on the great circle
"-node" : node of the great circle
"-inclination" : inclination of the great circle
C ROUTINE CALLED:
atEqToGal in atSurveyGeometry.c
TCL SYNTAX:
eqToGal "<ra>" "<dec>"
TCL HELP STRING:
convert equatorial coordinates to galactic coordinates, in decimal degrees.
RETURN: keyed list with gLong and gLat
TCL ARGUMENTS:
:
"<ra>" : right ascension
"<dec>" : declination
C ROUTINE CALLED:
atGalToEq in atSurveyGeometry.c
TCL SYNTAX:
galToEq "<gLong>" "<gLat>"
TCL HELP STRING:
convert galactic coordinates to equatorial coordinates, in decimal degrees.
RETURN: keyed list with ra and dec
TCL ARGUMENTS:
:
"<gLong>" : galactic longitude
"<gLat>" : galactic latitude
C ROUTINE CALLED:
atEqToSurvey in atSurveyGeometry.c
TCL SYNTAX:
eqToSurvey "<ra>" "<dec>"
TCL HELP STRING:
convert equatorial to survey coordinates, in decimal degrees.
RETURN: keyed list with lambda, eta
TCL ARGUMENTS:
:
"<ra>" : right ascension
"<dec>" : declination
C ROUTINE CALLED:
atSurveyToEq in atSurveyGeometry.c
TCL SYNTAX:
surveyToEq "<lambda>" "<eta>"
TCL HELP STRING:
convert survey to equatorial coordinates, in decimal degrees.
RETURN: keyed list with ra,dec
TCL ARGUMENTS:
:
"<lambda>" : survey longitude
"<eta>" : survey latitude
C ROUTINE CALLED:
atGCToSurvey in atSurveyGeometry.c
TCL SYNTAX:
GCToSurvey "<mu>" "<nu>" "-node" "-inclination"
TCL HELP STRING:
convert Great Circle to survey coordinates, in decimal degrees
TCL ARGUMENTS:
:
"<mu>" : mu on the great circle
"<nu>" : nu on the great circle
"-node" : node of the great circle
"-inclination" : inclination of the great circle
C ROUTINE CALLED:
atSurveyToGC in at SurveyGeometry.c
TCL SYNTAX:
surveyToGC "<lambda>" "<eta>" "-node" "-inclination"
TCL HELP STRING:
convert survey to Great Circle coordinates, in decimal degrees
TCL ARGUMENTS:
:
"<lambda>" : survey latitude
"<eta>" : survey longitude
"-node" : node of the great circle
"-inclination" : inclination of the great circle
C ROUTINE CALLED:
atSurveyToAzelpa in atSurveyGeometry.c
TCL SYNTAX:
surveyToAzelpa "<lambda>" "<eta>" "<tstamp>"
TCL HELP STRING:
convert survey to azelpa coordinates, in decimal degrees.
RETURN: keyed list of az, el, and pa
TCL ARGUMENTS:
:
"<lambda>" : survey longitude
"<eta>" : survey latitude
"<tstamp>" : TAI time stamp
C ROUTINE CALLED:
atVEqToGC in atSurveyGeometry.c
TCL SYNTAX:
vEqToGC "<vRaMu>" "<vDecNu>" "-node" "-inclination"
TCL HELP STRING:
convert equatorial to great circle coordinates, in decimal degrees.
RETURN a keyed list of mu and nu.
TCL ARGUMENTS:
:
"<vRaMu>" : right ascensions to change to mu
"<vDecNu>" : declinations to change to nu
"-node" : node of the reference great circle
"-inclination" : inclination of the reference great circle
C ROUTINE CALLED:
atVGCToEq in atSurveyGeometry.c
TCL SYNTAX:
vGCToEq "<vMuRa>" "<vNuDec>" "-node" "-inclination"
TCL HELP STRING:
convert equatorial to great circle coordinates, in decimal degrees.
RETURN a keyed list of mu and nu.
TCL ARGUMENTS:
:
"<vMuRa>" : mu on the great circle to change to right ascensions
"<vNuDec>" : nu on the great circle to change to right ascensions
"-node" : node of the great circle
"-inclination" : inclination of the great circle
C ROUTINE CALLED:
atVEqToGal in atSurveyGeometry.c
TCL SYNTAX:
vEqToGal "<vRaGLong>" "<vDecGLat>"
TCL HELP STRING:
convert equatorial coordinates to galactic coordinates, in decimal degrees.
RETURN: keyed list with gLong and gLat
TCL ARGUMENTS:
:
"<vRaGLong>" : right ascension
"<vDecGLat>" : declination
C ROUTINE CALLED:
atVGalToEq in atSurveyGeometry.c
TCL SYNTAX:
vGalToEq "<vGLongRa>" "<vGLatDec>"
TCL HELP STRING:
convert galactic coordinates to equatorial coordinates, in decimal degrees.
RETURN: keyed list with ra and dec
TCL ARGUMENTS:
:
"<vGLongRa>" : galactic longitude
"<vGLatDec>" : galactic latitude
C ROUTINE CALLED:
atVEqToSurvey in atSurveyGeometry.c
TCL SYNTAX:
vEqToSurvey "<vRaLambda>" "<vDecEta>"
TCL HELP STRING:
convert equatorial to survey coordinates, in decimal degrees.
RETURN: keyed list with lambda, eta
TCL ARGUMENTS:
:
"<vRaLambda>" : right ascension
"<vDecEta>" : declination
C ROUTINE CALLED:
atVSurveyToEq in atSurveyGeometry.c
TCL SYNTAX:
vSurveyToEq "<vLambdaRa>" "<vEtaDec>"
TCL HELP STRING:
convert survey to equatorial coordinates, in decimal degrees.
RETURN: keyed list with ra,dec
TCL ARGUMENTS:
:
"<vLambdaRa>" : right ascension
"<vEtaDec>" : declination
C ROUTINE CALLED:
atDefineGC in atSurveyGeometry.c
TCL SYNTAX:
defineGC "<ra1>" "<dec1>" "<ra2>" "<dec2>"
TCL HELP STRING:
Given two points on a great circle, compute the node and incl.
TCL ARGUMENTS:
:
"<ra1>" : right ascension
"<dec1>" : declination
"<ra2>" : right ascension
"<dec2>" : declination
C ROUTINE CALLED:
atGCDecFromRa in atSurveyGeometry.c
TCL SYNTAX:
GCDecFromRa "<ra>" "-node" "-inclination"
TCL HELP STRING:
Given an RA, find a corresponding dec on the great circle.
TCL ARGUMENTS:
:
"<ra>" : right ascension
"-node" : node of the reference great circle
"-inclination" : inclination of the reference great circle
C ROUTINE CALLED:
atAngleGCToRa in atSurveyGeometry.c
TCL SYNTAX:
angleGCToRa "<ra>" "<dec>" "-node" "-inclination"
TCL HELP STRING:
Given a point on the great circle, determine the angle between
the great circle and increasing ra.
TCL ARGUMENTS:
:
"<ra>" : right ascension
"<dec>" : declination
"-node" : node of the reference great circle
"-inclination" : inclination of the reference great circle
C ROUTINE CALLED:
atCoordToCobePix in atSurveyGeometry.c
TCL SYNTAX:
coordToCobePix "<longitude>" "<longitude>" "<coord>" "-resolution"
TCL HELP STRING:
Given a sky position, coordinate projection, and resolution, return the COBE pixel number.
TCL ARGUMENTS:
:
"<longitude>" : sky position longitude
"<longitude>" : sky position latitude
"<coord>" : coordinate system: q for Equatorial; g for galactic; e for ecliptic
"-resolution" : on each face; 9 for DIRBE data
C ROUTINE CALLED:
atCobePixToCoord in atSurveyGeometry.c
TCL SYNTAX:
cobePixToCoord "<pixel>" "<coord>" "-resolution"
TCL HELP STRING:
Given a pixel number, coordinate projection, and resolution, return the coordinates of the center of the pixel.
TCL ARGUMENTS:
:
"<pixel>" : the pixel number
"<coord>" : coordinate system: q for Equatorial; g for galactic; e for ecliptic
"-resolution" : on each face; 9 for DIRBE data
C ROUTINE CALLED:
atVCoordToCobePix in atSurveyGeometry.c
TCL SYNTAX:
vCoordToCobePix "<vLongitude>" "<vLatitude>" "<coord>" "-resolution" "<vPixel>"
TCL HELP STRING:
convert vectors of coordinates to COBE pixel numbers.
TCL ARGUMENTS:
:
"<vLongitude>" : longitudes
"<vLatitude>" : latitudes
"<coord>" : coordinate system: q for Equatorial; g for galactic; e for ecliptic
"-resolution" : on each face; 9 for DIRBE data
"<vPixel>" : ouput pixel values
C ROUTINE CALLED:
atVCobePixToCoord in atSurveyGeometry.c
TCL SYNTAX:
vCobePixToCoord "<vPixel>" "<coord>" "-resolution" "<vLongitude>" "<vLatitude>"
TCL HELP STRING:
convert vectors of coordinates to COBE pixel numbers.
TCL ARGUMENTS:
:
"<vPixel>" : ouput pixel values
"<coord>" : coordinate system: q for Equatorial; g for galactic; e for ecliptic
"-resolution" : on each face; 9 for DIRBE data
"<vLongitude>" : longitudes
"<vLatitude>" : latitudes
C ROUTINE CALLED:
atparallacticAngleGC in atSurveyGeometry.c
TCL SYNTAX:
parallacticAngleGC "<mu>" "<nu>" "<tstamp>" "<node>" "<incl>"
TCL HELP STRING:
Calculate the parallactice angle to the zenith wrt mu,nu axes
TCL ARGUMENTS:
:
"<mu>" : great circle longitude
"<nu>" : great circle latitude latitude
"<tstamp>" : TAI time stamp
"<node>" : node of the great circle
"<incl>" : inclination of the great circle
C ROUTINE CALLED:
atsiteSetByName in atSurveyGeometry.c
TCL SYNTAX:
siteSetByName "<name>"
TCL HELP STRING:
Set the location of the observatory
TCL ARGUMENTS:
:
"<name>" : name of observatory. A legal list of name is returned on error
C ROUTINE CALLED:
atsiteSet in atSurveyGeometry.c
TCL SYNTAX:
siteSet "<longitude>" "<latitude>" "<altitude>" "<name>"
TCL HELP STRING:
Set the location of the observatory
TCL ARGUMENTS:
:
"<longitude>" : geodetic longitude of observatory in degrees
"<latitude>" : geodetic latitude of observatory in degrees
"<altitude>" : altitude of observatory in meters
"<name>" : name of the site