• eqToGC
  • GCToEq
  • eqToGal
  • galToEq
  • eqToSurvey
  • surveyToEq
  • GCToSurvey
  • surveyToGC
  • surveyToAzelpa
  • vEqToGC
  • vGCToEq
  • vEqToGal
  • vGalToEq
  • vEqToSurvey
  • vSurveyToEq
  • defineGC
  • GCDecFromRa
  • angleGCToRa
  • coordToCobePix
  • cobePixToCoord
  • vCoordToCobePix
  • vCobePixToCoord
  • parallacticAngleGC
  • siteSetByName
  • siteSet
  • 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
    
    

    eqToGC

     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
    
    

    GCToEq

     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
    
    

    eqToGal

     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
    
    

    galToEq

     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
    
    

    eqToSurvey

     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
    
    

    surveyToEq

     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
    
    

    GCToSurvey

     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
    
    

    surveyToGC

     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
    
    

    surveyToAzelpa

     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
    
    

    vEqToGC

     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
    
    

    vGCToEq

     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
    
    

    vEqToGal

     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
    
    

    vGalToEq

     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
    
    

    vEqToSurvey

     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
    
    

    vSurveyToEq

     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
    
    

    defineGC

     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
    
    

    GCDecFromRa

     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
    
    

    angleGCToRa

     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
    
    

    coordToCobePix

     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
    
    

    cobePixToCoord

     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
    
    

    vCoordToCobePix

     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
    
    

    vCobePixToCoord

     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
    
    

    parallacticAngleGC

     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
    
    

    siteSetByName

     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
    
    

    siteSet

     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