• transNew
  • transDel
  • transApply
  • transInverseApply
  • transInverseApplyNowrap
  • int
  • tclTrans

    ABSTRACT:
    
    Routines for creating, deleting, and using TRANS structs
    
    

    transNew

      atTransNew in atTrans.c
      
    
    TCL SYNTAX:
      transNew  
    
    TCL HELP STRING:
      Allocate a new TRANS object and set its elements to their unary values
    
    TCL ARGUMENTS:
                     : 
    
    

    transDel

      atTransDel in atTrans.c
      
    
    TCL SYNTAX:
      transDel  "<handle>" 
    
    TCL HELP STRING:
      Delete a TRANS.
    
    TCL ARGUMENTS:
                     : 
      "<handle>"   : Handle of TRANS to delete
    
    

    transApply

      atTransApply in atTrans.c
    
    
    DESCRIPTION:
    
    Apply a TRANS structure to convert CCD coordinates (row,col) in pixels to great circle coordinates (mu,nu) in degrees for an object measured in band .

    Returns the answer as a TCL keyed list, composed of the following keyword/value pairs: mu = great circle longitude (degrees); muErr = error in mu (degrees); nu = great circle latitude (degrees); nuErr = error in nu (degrees); status = 0 if calibrated using measued colors, 1 if calibrated using the cosmic color.

    TCL USAGE:
      
    USAGE: transApply <trans> <filter> <row> <rowErr> <col> <colErr>
                      -mag array -magErr array
    
    TCL SYNTAX:
      transApply  "<trans>" "<filter>" "<row>" "<rowErr>" "<col>" "<colErr>" "-mag" "-magErr" 
    
    TCL ARGUMENTS:
                     : 
      "<trans>"    : The TRANS in question
      "<filter>"   : Name of band (row,col)'s measured in
      "<row>"      : Frame row position (pixels)
      "<rowErr>"   : Error in row
      "<col>"      : Frame column position (pixels)
      "<colErr>"   : Error in col
      "-mag"         : Array of magnitudes in each band
      "-magErr"      : Array of errors in mag
    
    

    transInverseApply

      atTransInverseApply in atTrans.c
    
    
    DESCRIPTION:
    
    Apply the inverse of a TRANS structure to convert great circle coordinates (mu,nu) in degrees to CCD coordinates (row,col) in pixels for an object measured in band .

    Returns the answer as a TCL keyed list, composed of the following keyword/value pairs: row = row position (pixels); rowErr = error in row (pixels); col = column position (pixels); colErr = error in column (pixels); status = -1 if error inverting the trans, 0 if calibrated using measued colors, 1 if calibrated using the cosmic color.

    TCL USAGE:
      
    USAGE: transInverseApply <trans> <filter> <mu> <muErr> <nu> <nuErr>
                             -mag array -magErr array
    
    TCL SYNTAX:
      transInverseApply  "<trans>" "<filter>" "<mu>" "<muErr>" "<nu>" "<nuErr>" "-mag" "-magErr" 
    
    TCL ARGUMENTS:
                     : 
      "<trans>"    : Trans whose inverse should be applied
      "<filter>"   : Band in which (mu,nu) is measured
      "<mu>"       : Great circle longitude (degrees)
      "<muErr>"    : Error in mu
      "<nu>"       : Great circle latitude (degrees)
      "<nuErr>"    : Error in nu
      "-mag"         : Array of magnitudes in each band
      "-magErr"      : Array of errors in mag
    
    

    transInverseApplyNowrap

      atTransInverseApplyNowrap in atTrans.c
    
    
    DESCRIPTION:
    
    Apply the inverse of a TRANS structure to convert great circle coordinates (mu,nu) in degrees to CCD coordinates (row,col) in pixels for an object measured in band .

    Returns the answer as a TCL keyed list, composed of the following keyword/value pairs: row = row position (pixels); rowErr = error in row (pixels); col = column position (pixels); colErr = error in column (pixels); status = -1 if error inverting the trans, 0 if calibrated using measued colors, 1 if calibrated using the cosmic color.

    TCL USAGE:
      
    USAGE: transInverseApplyNowrap <trans> <filter> <mu> <muErr> <nu> <nuErr>
                             -mag array -magErr array
    
    TCL SYNTAX:
      transInverseApplyNowrap  "<trans>" "<filter>" "<mu>" "<muErr>" "<nu>" "<nuErr>" "-mag" "-magErr" 
    
    TCL ARGUMENTS:
                     : 
      "<trans>"    : Trans whose inverse should be applied
      "<filter>"   : Band in which (mu,nu) is measured
      "<mu>"       : Great circle longitude (degrees)
      "<muErr>"    : Error in mu
      "<nu>"       : Great circle latitude (degrees)
      "<nuErr>"    : Error in nu
      "-mag"         : Array of magnitudes in each band
      "-magErr"      : Array of errors in mag
    
    

    int

     Given the name of a TCL array, generate an array of floats corresponding
     to its elements, and return the number of elements (or -1 in case of error)
    
     Do not forget to shFree *vals when you are done with it
    
    SIGNATURE:
      static int
      phFltArrayGetFromTclArray(Tcl_Interp *interp,
      			  char *arrayName, /* name of tcl array */
      			  char *indices, /* indices of tcl array */
      			  float **vals)	/* array to allocate and return */